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1  INTRODUCTION  :  DATA  LOGGER  CSCI  DESCRIPTION 


1 . 1  Background 

The  Data  Logger  is  a  network  management  tool  that  captures  the  events  of  an  exercise  run 
over  the  network  by  recording  the  SIMNET  Protocol  Data  Units  ^DU)  that  were  sent  by 
all  of  the  participants.  One  of  the  principles  of  distributed  simulation  is  that  individual 
participants  in  an  exercise  receive  all  the  relevant  data  about  other  participants  via  the 
network.  In  addition,  each  participant  is  responsible  fw  providing  local  state  information 
to  others  via  the  netwOTk.  Therefore,  by  saving  the  network  traffic  of  an  exercise  it  is 
possible  to  recreate  the  activity  of  the  exercise  by  playing  back  the  recorded  events.  This 
^lows  observers  and  participants  to  move  freely  through  the  logged  exercise  and  re¬ 
evaluate  their  performance. 

By  analyzing  the  logged  events,  a  post  exercise  evaluation  can  be  performed.  This  data 
analysis  activity  uses  the  file  saved  by  the  data  logger  to  perform  off  line  processing  on  the 
network  traffic  and  produce  generic  and  tailored  reports.  The  generic  report  typically 
attributes  battlefield  victories  by  individual  participants  in  summary  form.  A  tailored  report 
could  take  any  format,  but  is  typically  used  to  evaluate  the  detailed  status  and  performance 
of  an  individual  vehicle  in  the  exercise. 

The  data  logger  control  can  be  via  a  standard  terminal  interface,  or  remote  via  a  client  on  the 
network.  Control  options  include  record,  playback,  fast-forward,  rewind,  and  storage 
media  (i.e.  record  to  disk  or  tape). 

This  document  is  intended  to  provide  a  "roadmap”  through  the  Data  Logger  code.  It  is 
divided  into  tour  sections.  Section  1  will  provide  a  high  level  functional  description  of  the 
Data  Logger  CSCI.  It  will  describe  the  interfaces  of  this  CSCI  with  other  CSCI’s  in  the 
system  as  well  as  the  internal  structure  of  the  Data  Logger  CSCI. 

Section  2  will  describe  each  of  the  CSC's  which  make  up  the  Data  Logger  CSCI.  Each 
CSC  is  broken  down  into  its  component  CSU's  based  on  the  functionality  of  the  code. 
Section  2.1  describes  the  libraries  which  contain  tools  and  utilities  that  are  used  to  interact 
with  SIMNET.  Section  2.2  contains  information  about  the  code  that  runs  the  Data  Logger 
including  the  facilities  that  allow  the  person  running  the  Data  Logger  to  playback,  record, 
etc. 

Section  3  will  describe  the  resources  which  are  utilized  by  the  Data  Logger,  and  Section  4 
will  contain  the  source  code  listings. 


1 . 2  External  Interfaces 

The  data  logger  processes  all  external  communications  via  the  SIMNET  network.  The 
standard  proceduic  for  the  logger  is  to  be  recording  the  data  on  the  network,  or  to  be 
playing  recorded  data  back  in  a  time  sequenced  manner.  The  logger  can  be  controlled  by  a 
client,  typically  the  Plan  View  Display  (PVD)  using  a  protocol  specifically  designed  for  this 
purpose. 

When  the  Data  Logger  is  used  in  stand  alone  mode,  data  is  received  from  SIMNET  when 
recording,  and  data  is  sent  through  SIMNET  when  playing  back.  When  the  Data  Logger  is 
used  in  server  mode,  data  is  received  through  SIMNET  when  recording,  and  data  is  sent  to 
the  client  (usually  the  PVD)  through  SIMNET  when  playing  back.  Communications 
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between  the  client  and  the  Dam  Logger  are  sent  exclusively  through  SIMNET  using  a 
special  protocol  described  in.  Table  1.2-1.  This  communications  scheme  is  shown  in 


Figure  1.2-1. 


SIMNET 


Figure  1.2*1:  Communications  Scheme 
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PDU 

Protocol 

Data  Unit 

CSCI 

Received 

From 

CSCI 

Sent  To 

In 

Response 

To 

Protocol 

Type 

Transaction 

Type 

loggerAvail 

RequestPDU 

Kind 

Client  (PVD) 

Data  Logger 
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an  available 
Data  Logger 

Logger 

Broadcast 

Datagram 

logger 

Connect 

RequestPDU 

Kind 

Client  (PVD) 

Data  Logger 

Requesting 
connection 
with  specific 
Data  Logger 

Logger 

(MpDatagram 

logger 

Command 

Request 

PDUKind 

Client  (PVD) 

Data  Logger 

Specifying 

runtime 

commands 

Logger 

ptpDatagram 

loggerStatusR 

equest 

PDUKind 

Client  (PVD) 

Data  Logger 

Gathering 
information 
about  current 
operating 
status 

Logger 

ptpDatagram 

logger 

Disconnect 

Request 

PDUKind 

Client  (PVD) 

Data  Logger 

Terminate 
Connection  of 
Data  Logger 

Logger 

ptpDatagram 

loggerAckPDU 

Kind 

Data  Logger 

Client  (PVD) 

Reply  to 
successful 
client  reguests 

Logger 

ptpDatagram 

loggerNak 

PDUKind 

Data  Logger 

Client  (PVD) 

Reply  to  Failed 
client  reguests 

Logger 

ptpDatagram 

Data  Logger 

Client  (PVD) 

Reply  to  client 

availibility 

reguests 

Logger 

ptpDatagram 

loggerStatus 

Reply 

PDUKind 

Data  Logger 

Client  (PVD) 

Reply  to  client 

status 

reguests 

Logger 

ptpDatagram 

logger 

Information 

PDUKind 

Data  Logger 

Client  (PVD) 

Communicate 
unsolicited 
information  to 
the  client 

Logger 

ptpDatagram 

loggerClock 

TickPDUKind 

Data  Logger 

Client  (PVD) 

Communicate 

timing 

information  to 
client 

Logger 

ptpDatagram 

Data  Logger 

—  _ _ 

Client  (PVD) 

ptpDatagram 

Table  PDU's  Used  by  the  Data  Logger 


1 . 3  Internal  Structure 


When  the  Data  Logger  application  is  run  it  first  interprets  command  line  switches  and 
allocates  the  system  resources  needed  to  execute.  The  resources  vary  depending  on  whether 
the  exercise  is  being  logged  (or  played  back  from)  a  tape  or  a  disk  file.  The  logger  then 
enters  a  command  mode  where  it  interprets  client  commands  such  as  record,  play,  or  fast 
forward. 
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A  standard  'fast  input  /output'  library  was  developed  to  enable  the  logger  ^plication  to 
service  the  disk  or  the  tape  in  a  transparent  manner.  This  allows  the  same  entry  points  to  be 
used  by  the  logger  application  regardless  of  the  media  that  is  accessed. 


In  systems  that  have  a  9-track  tape  drive,  a  second  CPU  is  often  used  to  handle  the  tape 
drive  processing.  This  allows  the  main  process  to  service  the  netwoiic  in  a  timely  manner 
and  not  be  tied  up  pending  on  the  relatively  slow  tape  device. 


The  structure  of  the  Data  Logger  is  shown  in  Figure  1.3-1.  The  Data  Logger  software 
consists  of  a  set  of  shared  libraries  and  the  Data  Logger  files. 


Figure  1.3-1:  Data  Logger  CSCI  Structure 
The  following  two  (2)  CSCs  are  associated  with  this  CSCI: 

Libraries 

Data  Logger  Files 

1.4  Configuration  and  Configuration  Management 

The  Data  Logger  program  host  is  an  MC  5600  MASSCOMP  computer.  The  software 
for  the  Data  Logger  functions  is  written  in  C. 

1.5  Terminology  and  Documentation 

The  following  documents  provide  additional  information  about  the  Data  Logger  system: 


SIMNET  Data  Collection/Data  Review,  October  1989 

The  SIMNET  Network  and  Protocols,  Arthur  R.  Pope,  July,  1989 
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2 . 1  Libraries 


Data  Logger  Libraries 

4.1 


Libassoc 


Li  blogtime 


- 4.1.3. 

- 4.1.3.; 


1  logtime.h 

2  logtime.c 


Interface 

Files 


4.1 .4.2 


4. 1.4. 1.1  fiolib.h 

4.1. 4.1. 2  fioheader.h 

4. 1.4. 1.3  fioerror.h 


4.1. 4.2.1  fiofile.h 

4.1. 4.2.2  fiolib.c 

4.1. 4.2.3  fioheader.c 

4.1 .4.2.4  fioerror.c 

4.1. 4.2.5  fiocvt.h 

4.1 .4.2.6  fiocvt.c 

4.1. 4.2.7  fioutil.h 

4.1. 4.2.8  fioutil.c 
4.1.4.2.9fiodisk.h 
4.1. 4.2.1  Ofiodisk.c 

4.1.4.2.11  fionet.h 

4.1.4.2.12  fionet.c 

4.1.4.2.13  fiotape.h 
4.1.4.2.14fiotape.c 


Figure  2.1-1:  Data  Logger  Libraries  Software  Structure 
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2.1.1  libassoc 
Association  Layer 

The  SIMNET  Association  Layer  provides  networic  services  to  sendAeceive  datagrams,  and 
exactly  once  (xo)  transactions.  It  also  provides  a  subscription  service  to  multicast 
addresses  on  Ae  network,  allowing  an  individual  application  to  selectively  acceptAeject 
network  traffic  from  different  SIMNET  exercises,  and  different  protocols  within  an 
exercise.  Libassoc  communicates  with  the  network  through  libnetif  to  provide  these 
services.  Reference  Section  2.20.1  of  the  MCC  CSCI  (1)  documentation. 

The  Data  Logger  does  NOT  use  the  Association  Layer  to  handle  sendingAeceiving 
datagrams.  Rather  it  communicates  directly  with  the  layer  of  networic  services  provided  by 
the  libnetif.  However,  it  uses  the  Association  Layer  to  aid  in  the  constructicMi  of  packets 
belonging  to  a  special  purpose  protocol.  The  server  Data  Logger  uses  this  protcxjol  to 
coiiununicate  with  its  clients  (e.g.  the  PVD).  Reference  Appendix  B. 

2.1.2  Network  Interface  Access:  libnetif 

Libnetif  provides  a  high  performance  pathway  to  an  unreliable  datagram  transport  service 
such  as  that  provided  by  an  IEEE  802.3  network.  Libnetif  also  provides  several 
miscellaneous  functions  for  controlling  the  network  addapter  unit  The  miscellaneous 
functions  allow  applications  to  take  advantage  of  adapter  specific  capabilities  such  as 
multicast  addressing,  high  granularity  timers,  and  intelligent  on-board  processors. 
Reference  Section  2.20.2  of  the  MCC  CSCI  (1)  documentation. 

2.1.3  Logger  Time  Library:  liblogtime 

This  library  provides  functions  for  converting  logger  timing  information  to  and  from 
human  readable  form. 

2. 1.3.1  logtime. h 

External  Procedure  Declarations: 
strings_to_datetime() 
datetime  ro_strings() 
get_datetTme() 
offset_datetime() 

2.1.3.2  logtime.c 

This  file  defines  a  set  of  routines  for  handling  the  communication  and  display  of  logger 
timing  information. 

Includes: 

<sysAypes.h> 

<sysAimeb.h> 

<time.h> 

<stdio.h> 

"pJogger.h" 

"logtime.h" 


6 


BBN  Systems  and  Technologies 


Data  Logger  CSQ 


Imported  Procedure  Declarations: 
timerO 
strncpyO 
strcpyO 
strchrO 

Static  Procedure  Declarations: 
itoa() 
monthtoiO 

Defines: 


UNKNOWN.TIMEZONE 

Static  Variable  Declaration: 
month_table[13] 

2. 1.3. 2.1  itoa 

This  routine  converts  an  integer  i  to  an  ASCII  character  s. 


Parameters 


Parameter 


Where  Typedef  Declared 


Standard 


Standard 


Table  2.1-1:  itoa  Information. 

2. 1.3. 2. 2  monthtoi 

This  routine  converts  a  month  m  (of  the  format  JAN,  FEB,  MAR,  etc.)  to  an  integer  i. 


Parameter 


1121^ 

irs 


Parameters 


inter  to  char 


Where  Typedef  Declared 


Standard 


variable 


Internal  Variables 


e 


Where  Typedef  Declared 


Standard 


Return  Value 


Return  Values 


Meanin 


The  integer  value  of  the 
month  (1-12) 


r 


Function 


et  datetime 


Called  B 


Where  Described 


Sec.  2.1. 3.2.6 


Table  2.1-2:  monthtoi  Information. 
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2. 1.3. 2. 3  string_to_seconds 

This  routine  converts  a  time  string  time  string  (of  the  format:  HH:MM:SS)  to  seconds. 


Parameters 


inter  to  char 


Internal  Variables 


Parameter 


time  stri 


Where  Tvoedef  Declared 


Standard 


Variable 


buffe 


s 


t 


hours 


minutes 


seconds 


char 


inter  to  char 


inter  to  char 


int 


mt 


int 


irs 

irs 


Where  Tvoedef  Declared 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Return  Values 


Return  Value 


3600hours  +  eominutes  + 
seconds 


-1 


The  time  in  seconds 


Procedure  failed 


Called  B 


Function 

Where  Described 

collect  racal  time  info 

Sec.  2.2.2.7.1 

scan  handler 

Sec.  2.2.2.5.12 

Table  2.1-3:  string_to_seconds  Information. 

2. 1.3. 2. 4  stnngs_to_datetime 

This  routine  converts  a  UNDC  syle  date/time  passed  in  date  string  and  time  string  (of  DD- 
MM:  YY/HH:MM:SS  format)  to  a  LoggerTime  format  (year,  month,  day,  hour,  minute, 
second,  timezone,  daylight  savings  time)  in  timeptr. 


Parameter 


I  on 


date  stri 


time  stn 


Parameters 


inter  to  LoaoerTime 


inter  to  char 


inter  to  char 


Where  Tvoedef  Declared 


Standard 


Standard 


Variable 


buffe  rf  4 


ieit: 


Internal  Variables 


e 


Where  Tvoedef  Declared 


Standard 


Function 


er  start 


Called  B 


Where  Described 


Sec.  2.2.2.2.29 


Table  2.1-4:  strings_to_datetime  Information. 
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2. 1.3. 2. 5  datetinie_to_strings 


This  routine  converts  a  time  from  LoggerTime  format  in  tUneptr  to  a  UNIX  style  fcamat  in 
date  string  and  time  string. 


1  Parameters  1 

Parameter 

Tvne 

1  Where  Tvpedef  Declared  1 

timeptr 

Dointer  to  LoaaerTime 

date  strina 

pointer  to  char 

standard 

time  strina 

pointer  to  char 

Standard 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

buffer[41 

char 

Standard 

1  Called  By  I 

1  Function  { 

Where  Described 

Sec.  2.2.2.2.29 

Unit  loaaer  for  copvina 

Sec.  2.2.2.2.7 

Table  2.1*5:  datetime_to_strings  Information. 


2. 1.3. 2. 6  get^datetime 


This  routine  gets  the  current  local  date/dme  from  Unix  in  unix  time  string  and  converts  it 
to  internal  LoggerTime. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

dime 

pointer  to  array  of  char 

Standard 

Unix  time  strina 

pointer  to  char 

Standard 

clock 

Iona 

Standard 

buffer 

array  of  char 

Standard 

Calls 

Function  1 

Where  Described 

monthtoi 

Sec.  2.1. 3.2.2 

Called  By 

Function 

Where  Described 

init  loaaer  for  copvina 

Sec.  2.2.2  2.7 

init  loaaer  for  recordina 

Sec.  2.2.2.2  9 

Table  2.1-6:  get_datetime  Information. 
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This  routine  adds  the  specified  number  of  seconds  to  the  supplied  LoggerTime  (timeptr). 


Parameter 


timeotr 


seconds 


Parameters 


inter  to  LoaoerTime 


unsianed 


Where  Tyoedef  Declared 


Standard 


Variable 


sec 


min 


hr 


lEIT] 


Internal  Variables 


e 


Where  Tvoedef  Declared 


Standard 


Standard 


Standard 


Standard 


Standard 


Table  2.1-7:  offset  datetime  Information. 
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2.1.4  Fast  10  Library:  libfio 

libfio  is  a  high  performance,  packet-oriented  Input/Output  library  for  reading  and  writing 
SIMNET  data  files.  It  is  based  on  the  UNIX  file  Inpu^Output  library  "q)en",  "read", 
"write",  and  "close"  level.  The  libfio  provides  a  unified  interface  for  handling  SIMNET 
simulation  and  voice  packets  on  diverse  mediums  including  the  SIMNET  network,  disk,  or 
9-track  tape.  It  provides  commands  for  opening,  reading,  writing,  seeking,  and  closing 
SIMNET  data  files.  In  addition,  it  provides  a  function  for  concatenating  disk  or  tape  files 
into  a  single  logical  unit.  This  is  particularly  usefiil  with  the  dual  tape  Data  Logger.  Tape 
concatenation  enables  the  recording  of  long  exercises  whoe  the  amount  of  data  is  expected 
to  exceed  the  capacity  of  a  single  tape  reel. 

The  fiolib  provides  real  time  I/O  at  data  rates  on  the  order  of  225  Kbytes  per  second  (about 
1 3(X)  packets  per  second).  The  fiolib  is  able  to  support  I/O  either  in  blocking  or  non- 
blocking  naode. 

2. 1.4.1  Libfio  Interface  files 

The  libfio  interface  files  constitute  the  set  of  header  files  which  must  be  included  in 
applications  using  the  libfio.  One  of  the  functions  provided  by  these  header  files  is  the 
definitions  of  the  SIMNET  data  file  components.  Reference  Appendix  A  for  a  mapping  of 
the  SIMNET  data  file  structure. 


2. 1.4. 1.1  fiolib.h 

This  file  defines  the  interface  to  the  Fast  I/O  Library  SIMNET  data  file  structure.  Reference 

Appendix  A  for  a  mapping  of  the  SIMNET  data  file  structure. 

Procedural  entry  point  declarations: 
fio_file_type() 
fio~open() 
fio~concat() 
fio_read() 
fio~write() 
fio_seek() 
fio_getrawfd() 
fio~flush() 
fio_close() 

Flags,  parameter  values,  and  macros  for  the  procedural  entry  points  are  defined: 

Defines  for  fio_file_type: 

HO_CMC_NETWORK 
HO_NINETRACK_TAPE 
HO_CARTRIDGE_TAPE 
HO_FLOPPY_TAPE 
FIO.DISK 
nO_NULL_TYPE 


-network  file 
-nine-track  tape  file 
-Not  Supported 
-Not  Supported 
-disk  file 
-NULL  file 
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Flags  and  Macros  for  fio_open: 

FIO_APPEND 
FTO.CTG 

MO.LOOP 
FIO.NBLOCK 
MO.PROMISCUOUS 
ffIO_RDONLY 
FIO_RDWR 
FIO_REWOFFL 
MO_VERSIONl 
MO_VERSION2 
ff=IO_WRONLY 
ES.CONTINUOUSO 
ns  LCX)PING() 

HS_NBLOCKING() 

KS_READABLE() 

ES_VERSIONl() 

ES_VERSION2() 

BS_VERSION() 

HS_WRITABLE 

For  fio_i»pen  size  parameter: 

FIOSIZE_600 
FIOSIZE_1200 
FIOSIZE_2400 
FIOSIZE_TINY 
FIOSIZE.SMALL 

For  fiojflush  flags  parameter: 

E=10FLUSH_RECEIVE 
FIOFLUSH_TRANSMIT 

For  fio_«eek  whence  parameter: 

FIOSEEK_SET 

FIOSEEK.CUR 

flOSEEK_END 

For  fib_iseek  and  fio_getrawfd  vol  parameter: 

SnO_CURRENT_FD 

2.1. 4^1.2  fioheader.h 

This  is  tSie  interface  file  for  routines  accessing  fio_header  type  abstractions.  Every 
SIMNE'T  data  file  consists  of  a  fio_header  followed  by  an  a^itraiy  number  of  fixed  length 
file  reoovds.  The  fio_header  contains  information  to  be  used  by  DataProbe  while  collecting 
statisticad  information.  In  addition,  it  contains  a  count  of  the  number  of  file  rectn-ds  in  the 
file,  varnous  version  information  fields,  and  a  table  of  fio_packet  time  stamps  for  seeking  in 
the  file  foy  time.  Reference  Appendix  A  for  a  mapping  of  the  SIMNET  data  file  and  header. 
This  file  defines  the  structure  of  the  header  record  for  SIMNET  data  files  as  well  as 
declares  the  external  procedures  for  manipulating  the  header. 


-600’  9-track  tape 
-1200’  9-track  tape 
-2400’  9-track  tape 
-for  debugging  purposes 
-for  debugging  purposes 


-disk  files  must  be  contiguous  for  effeciency  during 
recording  (disk  files  only) 

-for  debug^ng  purposes 
-non-blocking  mode 

-pay  attention  to  everything  on  the  network 
-reil  only 

-read,  write  mode  (net  files  only) 

-rewind  off-line 

-for  conversion  purposes;  this  is  a  version  1  file 
-for  conversion  purposes;  this  is  a  version  2  file 
-write  only 
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2. 1.4. 1.3  fioerror.h 

This  file  provides  an  error  handling  capability  for  applications  using  the  fiolib.  It  defines  a 
set  of  error  conditions  and  declares  the  set  of  procedures  to  access  ^e  associated  error 
messages.  This  file  declares  the  procedures  defined  in  "fioerror.c",  fio_error(), 
fio_error_string(),  and  lists  the  fiolib  error  definition  codes. 

2. 1.4.2  Libfio  files 

These  files  make  up  the  libfio. 

2. 1.4.2. 1  fiofile.h 


This  file  contains  definitions  of  the  data  types  of  the  SIMNET  data  file  and  header 
structures  and  declares  certain  variables  as  these  types. 

Version  1  files  contain  no  fio  header  and  have  fixed  length  packets. 

Version  2  files  contain  an  fioheader,  use  variable  length  packets,  and  use  Ethernet  version  2 
protocol. 

Version  3-5  files  contain  no  changes 

Version  6  files  use  Ethernet  802.3  Ethernet  protocol. 


nO_SLOT_E 

PHYS_TYPE_E 

FIO_FILEJNFO 

nO_FILE 

nO_RECORD_HEADER 

nO.RECORD 


fio_slot_e 

phys_e 

file_info 

fio_file_t,  fio_file_p 

fio_recotd_header 

fio_record 


Defines  of  constants  and  macros: 

nOLIB_VERSION2_CHKSUM 

FIOLIB_VERSION6_CHKSUM 

nOLIB_VERSION_CHKSUM 

n01.IB_MAJ0R_REVNUM 

nOLIB_MINOR_REVNUM 

nO_RECORD_BYTES 
FIO_RECORD_BYTES_VERSION  1_DISK 
nO_RECORD  BYTES_VERSIONl_TAPE 
HO_RECORD_PACKET_BYTES 
BLOCK_SIZE 
HO_RECORD_BLOCKS 
nO_RECX)RD_PACKETS  () 
nO_RECORD_BYTE_COUNT  () 


Version  2  file. 

Version  6  file. 

Major  revision  number  of 
libfio. 

Minor  revision  number  of 
libfio 


2. 1.4. 2. 2  fiolib.c 


This  file  along  with  "fioerror.c"  and  "fioheader.c"  contain  the  set  of  external  procedures 
which  constitute  the  interface  to  the  libfio.  They  dispatch  specific  routines  to  media 
depending  on  the  type  of  the  specified  file  handle. 
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Includes; 

<stdio.h> 

<ermo.h> 

<sys/types.h> 

Tiolib.h" 

"fioerror.h" 

Tiofile.h" 

"fioheader.h" 

"fiotape.h" 

"fionet.h" 

*Tiodisk.h" 

Declarations: 

fio_volume_nuinber 

fio_seek_volume 

fio_seek_time 

fio_file_t 

device_types 

fio_lib_initialized 

Static  procedure  declarations: 
ini_nolib() 

External  procedure  declarations; 

fopenO 

Constant  and  Macro  defines: 

FIO_MAX_OPEN 

FIOPTR.OFO 

IS_VALID_FD() 

CONTIGUOUSO 

nOTYPEO 

nO_DEVICE_NAMES_FILE 

2. 1.4. 2. 2.1  ini_file_slots 

ini  flle_siots  initializes  the  open_riles  array.  Each  of  the  25  files  (the  value  of 

Fl0_MAX_OPEN,  which  is  defined  extemily)  is  initialized  with  the  following 

characteristics; 

state:  nO_SLOT_AVAIL 
type;  FIO_NULL_TYPE 
open_flags:  0 
curvol:  -1 
info.iptr:  NULL 


1  internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

fdptr 

fio  file  p 

Sec.  2.1. 4.2.1  fiofile.h 

fd 

fio  desc 

Sec.  2. 1.4. 1.1  fiolib.h 
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1  Called  By  1 

Function 

Where  Described 

ini  fiolib 

Sec.  2.1.4.2.2.13 

Table  2.1-8:  ini_file_slots  Information. 


2. 1.4. 2. 2. 2  rind_file_slot 

fin(l_file_sIot  finds  an  available  slot  in  the  open  files  array  and  returns  the  index  of  the 
first  available  open  file  descriptor.  This  procedure  checks  for  the  the  lowest  indexed  file 
with  a  state  of  nO_SLC)T_AVAIL,  changes  the  state  to  FIO_SLOT_UNAVAIL,  and 
returns  the  file  index  in  fd. 


Variable 


fdotr 


fd 


Internal  Variables 


fio  file 


fio  desc 


Where  Tvoedef  Declared 


Sec.  2.1. 4.2.1  fiofile.h 


Sec.  2. 1.4. 1.1  fiolib.h 


Return  Value 


fd 


Return  Values 


fio  desc 


Meanin 


The  index  of  the  first  available 
member  of  the  open  file  array 


Called  B 


Function 

Where  Described 

fio  open 

Sec.  2.1. 4  2.2.5 

Table  2,1-9:  find_file_slot  Information. 

2. 1.4. 2. 2. 3  free_file_slot 

The  first  available  slot  in  the  open_files  array  was  determined  in  find_file_slot()  and 
returned  in  fd.  free_rile_slot()  frees  the  file  slot  passed  in  fd  by  giving  it  the  following 
file  characteristics:  ~ 

state:  FIO_SLOT_AVAIL 
type:  FIO_NULL_TYPE 
open_flag"  0 
curvol:  -i 
info.iptr:  NULL 


Parameters 

Parameter 

Where  Typedef  Declared 

fd 

Ifio  desc  1 

Sec.  2.1. 4.1.1  fiolib.h 

Variable _ Type _ Where  Typedef  Declared 

fdptr _ register  fio  file  p _ Sec.  2.1. 4.2.1  fiofile.h _ 
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1  Calls  1 

Function 

Where  Described 

FIOPTR  OF 

Sec.  2.1. 4.2.2  fiolib.c  (macro  definition) 

Table  2.1-10:  free_file_slot  Information. 


2. 1.4. 2. 2. 4  fio_file_type 

This  procedure  checks  the  path  name  of  the  file  to  determine  the  file  type.  The  device  name 
choices  are: 

"cmc"  -network 

"9tp"  -nine  track  tape 

"ctp"  -cartridge  tape  (not  supported) 

"ftp"  -floppy  tape  (not  supported) 

"dsk"  -disk 
NULL 

This  procedure  defines  BUFFER_SIZE  as  32. 


n 


Parameter 


ath 


IBT? 
lltS 


Parameters 


inter  to  char 


Where  TvDedef  Declared 


Standard 


Variable 


buffer 


devname 


lUJlddriiEBi 

imsaaEss 


Internal  Variables 


e 


chararra 


chararra 


inn 


Where  Typedef  Declared 


Standard 


Standard 


Standard 


Standard 


Standard 


Return  Value 


FIO  DISK 


Ein 


Return  Values 


FIO  ERROR 


Meanin 


The  integer  code  for  the  disk 
device  type 


The  integer  code  for  a  device 
other  than  disk 


The  procedure  failed 


Error 


FIO_DEVICE_FILE_ERROR 


FIO_DEVICE_TYPE_ERROR 


FIO  DEVICE  NAME  ERROR 


Errors 


Reason  for  Error 


The  devices  file  7simnet/data/fiodevs'  is 
missing 


Error  in  Vsimnet/data/fiodevs'  for  the  specified 
file 


The  specified  device  name  is  an  unsupported 
UNIX  device 


Called  B 


Function 

Where  Described 

fio  open 

Sec.  2,1.4.2  2.5 

Table  2.1-11:  fio_file_type  Information. 
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2. 1.4. 2. 2. 5  fio_open 

fio_open  returns  the  file  descriptor, /d,  for  a  named  file  which  can  then  be  used  by  the 
calling  process  for  input/output  operations.  The  path  argument  points  to  a  null  terminated 
string  containing  the  pathname  of  the  file  to  be  opened.  The  path  can  refer  to  a  tape  drive,  a 
disk  file,  or  a  network  name.  The  oflag  argument  sf^ifies  the  file  status  flags  associated 
with  the  file  descriptor  and  can  be  constructed  by  oring  together  flags  fnxn  the  following 
list.  Exactly  one  from  the  first  two  flags  must  be  specified: 


FIO_RDONLY  Open  for  reading  only. 


HO_WRONLY 

nO.CREATE 

FIO_CTG 


HO_BLOCK 


Open  for  writing  only. 

If  the  file  exists,  this  flag  has  no  effect  Otherwise,  this  flag  causes 
fio_open()  to  create  a  new  file. 

Verify  or  create  a  contiguous  disk  file.  This  flag  requires  that  the 
optional  size  argument  be  supplied.  The  specified  file  is  verified  to 
be  contiguous  and  at  least  the  specified  number  of  fio_packets.  If  a 
new  file  is  being  created  (the  FIO_CREATE  flag  is  set),  size 
fio^ackets  of  continuous  space  are  allocated  to  it  Any  call  to 
fio_write()  which  would  result  in  the  file  growing  larger  than  size 
fio_packets  will  fail  and  return  an  error.  Thus  flag  need  not  be  set  to 
open  an  existing  contiguous  file  unless  the  file  size  is  to  be  verified. 

Specify  synchronous  I/O. 


FIO_APPEND  fio__write()  will  append  the  file. 


For  disk  files,  the  size  argument  is  required  only  when  the  FIO_CJrG  flag  is  used.  In  this 
instance,  the  size  parameter  refers  to  the  minimum  size  of  the  file  in  bytes.  For  9-track  tape 
files,  the  size  argument  is  required  using  one  of  the  following  defines: 

FIO_SIZE_600  —  600'  9-track  tape 

nO_SIZE_1200  -  1200’ 9-track  tape 

FIO_SIZE_2400  -  2400' 9-track  tape 

Upon  successful  completion,  a  non-negative  file  descriptor /d  is  returned.  In  the  event  of 
an  error,  FIO_ERROR  is  returned. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

path 

pointer  to  char 

Standard 

oflaa 

int 

Standard 

size 

unsigned  long 

Standard 

header 

pointer  to  fio  header 

Sec.  2. 1.4.1. 2  fioheader.h 
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Internal  Variables 

Variable 

Where  Typedef  Declared 

fd 

Ifio  descr  I 

Sec.  2.1. 4.1.1  fiolib.h 

fdDtr 


e 


status 


fio  file 


int 


int 


Sec.  2.1. 4.2.1  fiofile.h 


Standard 


Standard 


Return  Values 


Return  Value 


FIO  ERROR 


fd 


fio  descr 


fio  descr 


Meanin 


An  error  is  returned 


fd  is  the  new  file  descriptor  for 
a  named  file  which  can  be 
used  by  the  calling  process  for 
input/output  operations 


Errors 

Error 

Reason  for  Error 

FIO_MAX_OPEN_ERROR 

The  maximum  number  of  open  files  has  been 
exceeded. 

FIOJNVALID_RDWR_FLAGS_ERROR 

The  file  has  invalid  FIO  RDONLY  and 

FIO  WRONLYflaos 

FIOJNVALID_VERSION_FLAG_ERROR 

Data  file  has  invalid  version  id;  cannot  be 
opened  for  writino 

FIO_DEVICE_FILE_TYPE_ERROR 

The  specified  UNIX  device  file  type  is  not 
supported  in  this  version 

FIO_DEVICE_FILE_ERROR 

The  devices  file  'simnet/data/fiodevs'  is 
missino 

Function 


ini  fiolib 


find  file  slot 


FIOPTR  OF 


fio  file  type 


IS  READABLE 


Calls 


Where  Described 


Sec.  2.1.4.2.2.13 


Sec.  2.1.4.2.2.2 


Sec.  2.1. 4.2.2  fiolib.c  (macro  definition 


Sec.  2.1. 4.2  2.4 


Sec.  2,1 .4.1.1  fiolib.h  (macro  definition 


Called  B 


Function 

Where  Described 

open  fio  files 

Sec.  2.2.2.2.10 

logger  init  cmc 

Sec.  2.2.2.2.11 

Table  2.1>12:  fio_open  Information. 

2. 1.4. 2. 2. 6  fio_concat 

This  procedure  concatenates  the  two  disk  files  or  two  tape  files  into  a  single  logical  file 
entity.  By  using  two  tape  drives  and  switching  tapes  as  soon  as  the  end  of  each  physical 
tape  is  reached,  ^ese  commands  can  be  used  to  handle  fio_packet  sequences  of  aibitrary 
length.  If  this  is  done,  however,  it  will  cause  some  special  problems  for  fio_seek()  since 
it  may  not  be  possible  to  seek  to  the  logical  beginning  or  end  of  the  concatenated  file 
without  operator  intervention.  Therefore,  in  the  case  of  concatenated  tape  files 
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FIOSEEK_SET  and  nOSEEK_END  are  relative  to  the  mounted  portion  of  the 
concatenated  file. 

fio_concat()  concatenates  the  file  represented  by  path  to  the  open  file  descriptor, /d. 
flo_concatO  accepts  only  tape  files  or  disk  files,  and  both  component  files  must  be  of  the 
same  type.  The  file  represented  by  path  inherits  all  its  characteristics  except  size  from  the 
open  nie.  fio  concatO  returns  a  new  file  descriptor  upon  successful  completion.  If  for 
some  iea.«^  tEe  concat  fails,  the  procedure  returns  FIO_ERROR. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

fd 

fio  descr 

Sec.  2.1. 4.1.1  fiolib.h 

path 

pointer  to  a  char 

Standard 

size 

unsianed  lonq 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

retval 

int 

Standard 

int 

Standard 

1  fdptr 

fio  file  p 

Sec.  2.1. 4.2.1  fiofile.h 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

FIO  ERROR 

fio  descr 

The  procedure  failed 

fd 

fio_descr 

the  new  file  descriptor  for  the 
concatenated  file 

1  Errors  1 

Error 

Reason  for  Error 

FIOJNVALID_FD_ERROR 

The  file  descriptor  does  not  correspond  to  an 
OPEN  file 

FIO  CONFLICTING  FILE  TYPES  ERROR 

The  file  descriptors  are  not  of  the  same  type 

FIO_DEVICE_FILE_TYPE_ERROR 

1  Calls  1 

Function 

Where  Described 

IS  VALID  FD 

Sec.  2.1. 4.2.2  fiolib.c  (macro  definition) 

FIOPTR  OF 

Sec.  2.1. 4.2.2  fiolib.c  (macro  definition) 

FIOTYPE 

Sec.  2.1. 4.2.2  fiolib.c  (macro  definition) 

tape  concat 

Sec.  2.1.4.2.14.17 

disk  concat 

Sec.  2.1.4.2.10.6 

1  Called  By  1 

Function 

Where  Described 

open  fio  files 

Sec.  2.2.2.2.10 

Table  2.1<13:  fio  concat  Information. 
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2. 1.4. 2. 2. 7  fio_read 

fio_read()  attempts  to  read  a  data  packet  pkt  from  the  object  referenced  by  the  descriptor 
/d  m  an  internal  buffer,  pkt  is  a  pointer  to  a  pointer  to  an  FIOlPACKET.  If  copy  is  TRUE 
then  fio_read  assumes  pkt  is  a  pointer  to  a  buffer  which  is  large  enough  for  the  largest 
simulation  packet,  and  copies  the  next  packet  in  the  specified  SIMNET  data  file.  If  copy  is 
FALSE,  fio_read  merely  assigns  the  address  of  the  next  simulation  packet  to  pkt.  This 
pointer  is  guaranteed  to  be  valid  until  the  next  time  fio_read  is  called.  This  routine  returns 
FIO_OK  upon  successful  completitm  and  FIO_ERROR  in  the  event  of  an  einx'. 


Parameter 


fd 


pkt 


Parameters 


fio  descr 


pointer  to  a  pointer  to 
fio  packet 


mt 


Where  Typedef  Declared 


Sec.  2.1. 4.1.1  fiolib.h 


Sec.  2.1. 4.1.1  fiolib.h 


Standard 


Variable 


retval 


fdptr 


Internal  Variables 


e 


int 


fio  file 


IE273 


Where  Typedef  Declared 


Standard 


Sec.  2.1. 4.2.1  fiofile.h 


Return  Values 


Return  Value 


FIO  ERROR 


FIO  OK 


fio  descr 


fio  descr 


Meanin 


The  procedure  failed 


The  procedure  was  successful 


Error 


FIOJNVALID_FD_ERROR 


FIO  NOT  READABLE  ERROR 


FIO_DEVICE  FILE  TYPE  ERROR 


Errors 


Reason  for  Error 


The  file  descriptor  does  not  correspond  to  an 
OPEN  file 


The  file  is  not  open  for  readin 


Function 


IS  VALID  FD 


FIOPTR  OF 


FIOTYPE 


IS  READABLE 


fnet  read 


read 


disk  read 


Calls 


Where  Described 


Sec.  2.1.4. 2.1  fiolib.c  (macro  definition 


Sec.  2.1. 4.2.2  fiolib.c  (macro  definition 


Sec.  2.1. 4.2.2  fiolib.c  (macro  definition 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.1.4.2.12.3 


Sec.  2.1.4.2.14.18 


Sec.  2.1.4.2.10.7 


Function 


looaer  oet  remote  rtc 


e 


er  playback  state 


loaoer  record  state 


Called  B 


Where  Described 


Sec.  2.2.2.2.13 


Sec.  2.2.2.2.16 


Sec.  2.2.2.2.18 


Sec.  2.2.2.2.19 


Table  2.1>14:  fio  read  Information. 
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2. 1.4. 2. 2. 8  no_write 

fio_write()  attempts  to  write  a  data  fio_packet  pkt  to  the  object  referenced  by  the 
descriptor /d. 

If  the  file  was  opened  with  the  FIO_APPEND  flag  set,  the  file  pointer  will  be  set  to  the  end 
of  the  file  prior  to  each  write.  This  routine  returns  FIO_OK  upon  successful  corr^letion, 
and  FIO  ERROR  in  the  event  of  an  errcH*. 


Parameter 


fd 


kt 


IT 


Parameters 


fio  descr 


inter  to  fio  packet 


irs 


Where  Tvpedef  Declared 


Sec.  2.1. 4.1.1  fiolib.h 


Sec.  2.1. 4.1.1  fiolib.h 


variable 


retval 


fdptr 


Internal  Variables 


e 


int 


fio  file 


ion 


Where  Typedef  Declared 


Standard 


Sec.  2.1. 4.2.1  fiofile.h 


Return  Values 


Return  Value 


FIO  ERROR 


FIO  OK 


IBT! 


e 


fio  descr 


fio  descr 


Meanin 


The  procedure  failed 


The  procedure  was  successful 


Errors 

Error 

Reason  for  Error 

FIOJNVALID_FD_ERROR 

The  file  descriptor  does  not  correspond  to  an 
OPEN  file 

FIO  NOT  WRITABLE  ERROR 


FIO  DEVICE  FILE  TYPE  ERROR 


The  file  is  not  open  for  writi 


The  specified  UNIX  device  file  type  is  not 
supported  in  this  version 


Function 


IS  VALID  FD 


FIOPTR  OF 


FIOTYPE 


IS  WRITABLE 


fnet  write 


wnte 


disk  write 


Calls 


Where  Described 


Sec.  2.1. 4.2.2  fiolib.c  (macro  definition 


Sec.  2.1. 4.2.2  fiolib.c  (macro  definition 


Sec.  2.1. 4.2.2  fiolib.c  (macro  definition 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.1.4.2.12.4 


Sec.  2.1.4.2.14.24 


Sec.  2.1.4.2.10.11 


Function 


looaer  put  remote  rtc 


e 


erolayback  state 


loaqer  record  state 


Called  B 


Where  Described 


Sec.  2.2.2.2.14 


Sec.  2.2.2.2.16 


Sec.  2.2.2.2.18 


Sec.  2.2.2.2.19 


Table  2.1-15:  fio  write  Information. 
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2. 1.4. 2. 2. 9  fio_seek 

This  routine  seeks  to  a  specified  locaticxi.  ^  is  a  file  descriptor  returned  from  an 
fio_open()  for  a  disk  file  or  a  tape  file.  fio_seek  is  valid  for  disk  and  tape  files  only. 
fio_seek()  sets  the  file  pointer  associated  with  fd  to  the  packet  specified  by  the  offset  and 
wHence  arguments.  Symbolic  ccmstants  for  whence  are  defined  as  follows: 

FIOSEEK_SET  Set  the  file  pointer  to  seconds  in  the  exercise 

FIOSEEK_CUR  Set  the  file  pointer  to  current  location  plus  offset  seconds 

HOSEEK.END  Set  the  file  pointer  to  End-Of-File  nmusoffsett  seconds 

fio_seek()  returns  FIO_OK  upon  successful  completion,  and  FIO_ERROR  in  the  event  of 
an  error. 


Parameter 


fd 


offset 


whence 


Parameters 


fio  descr 


int 


int 


Where  Tvpedef  Declared 


Sec.  2.1. 4.1.1  fiolib.h 


Standard 


Standard 


Variable 


retval 


fdotr 


Internal  Variables 


e 


mt 


fio  file 


Where  Tvoedef  Declared 


Standard 


Sec.  2.1. 4.2.1  fiofile.h 


Return  Value 


FIO  ERROR 


FIO  OK 


Return  Values 


e 


fio  desc 


fio  desc 


Meanin 


The  procedure  failed 


The  procedure  was  successful 


Errors 

Error 

Reason  for  Error 

FIOJNVALID_FD_ERROR 

The  file  descriptor  does  not  correspond  to  an 
OPEN  file 

FIO_SEEK_WRITABLE_FILE_ERROR 

Seeking  is  not  allowed  in  files  opened  for 
writino 

FIO  DEVICE  FILE  TYPE  ERROR 


Function 


IS  VALID  FD 


FIOPTR  OF 


FIOTYPE 


IS  WRITABLE 


tape  seek 


tape  seek  time 


disk  seek 


disk  seek  time 


Calls 


Where  Described 


Sec.  2.1. 4.2.2  fiolib.c  (macro  definition 


Sec.  2.1. 4.2.2  fiolib.c  (macro  definition 


Sec.  2.1. 4.2.2  fiolib.c  (macro  definition 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.1.4.2.14.30 


Sec.  2.1.4.2.14.31 


Sec.  2.1.4.2.10.15 


Sec.  2.1.4.2.10.16 
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~  1 

Called  By  1 

Function 

Where  Described 

looaer  seek  relative 

Sec.  2.2.2.2.26 

Table  2.1>16:  fio_seek  Information. 


2.1.4.2.2.10  fio_getrawfd 

This  routine  gets  the  UNDC  file  descriptor  associated  with  the  fiolib  file  descriptor fd.  The 
returned  file  descriptor  can  then  be  us^  in  Sitnnet  Netwoik  Library  calls  such  as 
net_filter().  In  the  event  of  an  error,  fio_getrawfd()  returns  FIO_ERROR.  Extreme 
care  should  be  taken  when  using  these  calls  since  they  are  taking  place  outside  the  scope 
and  therefore  outside  the  control  of  the  fiolib.  Using  UNIX  system  calls  is  particularly 
risky.  This  command  is  intended  to  supply  the  user  with  an  escape  to  the  more  esoteric 
Simnet  network  commands  which  are  not  supported  by  the  fiolib.  If  you  find  it  necessary 
to  call  UNIX  commands,  then  either  the  fiolib  interface  should  be  expanded,  or  you  shoidd 
not  be  using  fiolib. 


Parameters 


Parameter 


fd 


vol  offset 


e 


fio  descr 


inf 


Where  Typedef  Declared 


Sec.  2. 1.4. 1.1  fiolib.h 


Standard 


Internal  Variables 


Variable 


retvat 


fdptr 


int 


fio  file 


Where  Tvoedef  Declared 


Standard 


Sec.  2.1. 4.1.1  fiofile.h 


Return  Value 


FIO  ERROR 


retval 


Return  Values 


e 


fio  descr 


int 


ion 


Meanin 


The  procedure  failed 


The  raw  tape  or  disk  file 
descriptor 


Error 


FIOJNVALID_FD_ERROR 


FIO  DEVICE  FILE  TYPE  ERROR 


Errors 


Reason  for  Error 


The  file  descnptor  does  not  correspond  to  an 
OPEN  file 


The  specified  UNIX  device  file  type  is  not 
supported  in  this  version 


Function 


IS  VALID  FD 


FIOPTR  OF 


FIOTYPE 


tape  aetrawfd 


disk  aetrawfd 


Calls 


Where  Described 


Sec.  2.1 .4.2.2  fiolib.c  (macro  definition 


Sec.  2.1. 4.2.2  fiolib.c  (macro  definition 


Sec.  2.1. 4.2.2  fiolib.c  (macro  definition 


Sec.  2.1.4.2.14.35 


Sec.  2.1.4.2.10.20 


Table  2.1<17:  fio_getrawfd  Information. 
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2.1.4.2.2.11  fiojiush 

flo_flush()  is  valid  for  networit  files  only,  net  flush  in  the  libnetif  is  called  to  flush  the 
transmit  or  receive  buffers.  The  flags  argumentls  used  to  specify  which  of  these  buffers  is 
to  be  affected:  FIOFLUSH_TRANSMIT  or  FIOFLUSH_RECErVE.  flags  is  a  bit  vector. 


Parameter 


fd 


s 


Parameters 


fio  descr 


int 


Where  Tvoedef  Declared 


Sec.  2.1. 4.1.1  fiolib.h 


Standard 


Variable 


status 


Internal  Variables 


fio  file 


int 


Where  Typedef  Declared 


Sec.  2.1. 4.1.1  fiofile.h 


Standard 


Return  Value 


FIO  ERROR 


FIO  OK 


Return  Values 


e 


fio  desc 


int 


1 127:1 


Meanin 


The  orocedure  failed 


The  procedure  was  successful 


Error 


FIO_INVALID_FD_ERROR 


FIO  INTERNAL  ERROR 


FIO  DEVICE  FILE  TYPE  ERROR 


Errors 


Reason  for  Error 


The  file  descriptor  does  not  correspond  to  an 
OPEN  file 


fio  flush  is  not  supported  for  tape  files 


The  specified  UNIX  device  file  type  is  not 
supported  in  this  version 


Function 


IS  VALID  FD 


FIOPTR  OF 


FIOTYPE 


fnet  flush 


disk  oetrawfed 


Calls 


Where  Described 


Sec.  2.1. 4.2.2  fiolib.c  (macro  definition 


Sec.  2.1. 4.2.2  fiolib.c  (macro  definition 


Sec.  2.1. 4.2.2  fiolib.c  (macro  definition 


Sec.  2.1.4.2.12.5 


Sec.  2.1.4.2.10.20 


Function 


loaoer  continue 


lodoer  seek  relative 


er  start 


Called  B 


Where  Described 


Sec.  2.2.2.2.24 


Sec.  2.2.2.2.26 


Sec.  2.2.2.2.29 


Table  2.1-18:  fio  flush  Information. 


2.1.4.2.2.12  fio_close 

This  routine  closes  the  file  specified  by/d. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

fd 

fio  descr 

Sec.  2. 1.4. 1.1  fiolib.h 

1 
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Internal  Variables 


Variable 


status 


fio  file 


int 


Where  Tvoedef  Declared 


Sec.  2.1 .4.1.1  fiofile.h 


Standard 


Return  Values 


Return  Value 


FIO  ERROR 


FIO  OK 


Meanln 


An  error  is  returned 


The  orocedure  was  successful 


Errors 

Error 

Reason  for  Error 

FIOJNVALID_FD_ERROR 

The  file  descriptor  does  not  correspond  to  an 
OPEN  file 

FIO  DEVICE  FILE  TYPE  ERROR 


Function 


IS  VALID  FD 


FIOPTR  OF 


FIOTYPE 


fnet  close 


tape  close 


disk  close 


Calls 


Where  Described 


Sec.  2.1. 4.2.2  fiolib.c  (macro  definition 


Sec.  2.1. 4.2.2  fiolib.c  (macro  definition 


Sec.  2.1. 4.2.2  fiolib.c  (macro  definition 


Sec.  2.1.4.2.12.6 


Sec.  2.1.4.2.14.36 


Sec.  2.1.4.2.10.21 


Called  B 


Function 

Where  Described 

open  fio  files 

Sec.  2.2.2.2.10 

loqqer  reset 

Sec.  2.2.2.2.20 

Table  2.1-19:  no_close  Information. 
2.1.4.2.2.13  inijiolib 

This  routine  initializes  an  available  slot  in  the  open  files  array. 


Function 


ini  file  slots 


mi  disk 


ini  fnet 


ini  tape 


Calls 


Where  Described 


Sec.  2.1.4.2.2.1 


Sec.  2.1.4.2.10.4 


Sec.  2.1.4.2.12.1 


Sec.  2.1.4.2.14.15 


Function 


fio  open 


Called  B 


Where  Described 


Sec.  2.1. 4.2.2  5 


Table  2.1-20: 

ini_fiolib  Information. 

• 
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2. 1.4. 2. 3  fioheader.c 

Every  SIMNET  data  file  starts  with  a  24K  byte  header  block.  The  file  provides  routines 
for  accessing  the  infOTmaticm  in  that  header.  This  file  contains  external  procedures  for 
manipulating  SIMNET  data  file  headers.  Reference  Appedix  A  for  a  more  detailed 
mapping  of  the  SIMNET  data  header  structure. 

Includes: 

<stdio.h> 

"fiofile.h" 

"fioerror.h" 

"fioheader.h" 

"pJogger.h" 

Standard  procedure  declarations: 
strncpyO 

Static  procedure  declarations: 

construct_d  phdr() 

set_frame_size_(1ohdr() 

find_info() 

2. 1.4. 2. 3.1  fio_is_null_header 

This  procedure  returns  a  TRUE  if  the  header  specified  by  file  Mr  is  NULL. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

file  hdr 

pointer  to  fio  header 

Sec.  2.1. 4.1. 3  fioheader.h 

Return 

Values 

Return  Value 

Type 

Meanina 

TRUE 

int 

The  header  is  NULL 

FALSE 

The  header  is  not  NULL 

1  Called  Bv  1 

Function 

Where  Described 

fio  is  null  header 

Sec.  2.1.4.2.3.1 

Table  2.1-21:  fio_is_null_header  Information. 

2. 1.4. 2. 3. 2  fio_convert_header 

This  procedure  is  used  only  when  converting  Version  1  style  SIMNET  data  files  to  the 
latest  format  It  converts  old-style  headers  to  the  style  for  Version  2  and  later  data  files. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

file  hdr 

pointer  to  fio  header 

Sec.  2. 1.4. 1.3  fioheader.h 

frame  size 

int 

Standard 

file  id 

pointer  to  char 

Standard 

command  str 

pointer  to  char 

Standard 
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1  Calls  1 

Function 

Where  Described 

set  frame  size  fiohdr 

Sec.  2.1.4.2.3.18 

fio  insert  info 

Sec.  2.1. 4.2.3  6 

Called  By 

Function 

Where  Described 

init  loaaer  for  copyinp 

Sec.  2.2.2  2.7 

Table  2.1-22:  fio  convert  header  Information. 


2. 1.4. 2. 3. 3  no_file_header 

This  routine  constructs  an  fio_header  in  the  filejidr  buffer  provided. 
file  id,  num  exercises,  exercises,  command  str,  tape  type,  runjiuntber,  project  id, 
comment,  date  of  run,  tape  number,  bits _per_word, frame  size,  header  size, 
date  of  copy,  time  of  run,  and  time  of  launch  are  the  fio_header  fields  passed  in. 


Parameter 


file  hdr 


file  id 


num  exercises 


exercises 


command  str 


idt: 
\n 
irs 


Parameters 


n 

f! 


run  number 


reject  id 


comment 


date  of  run 


tape  number 


bits  per  word 


frame  size 


header  size 


date  of  CO 


time  Of  run 


time  of  launch 


inter  to  fio  header 


inter  to  char 


short 


inter  to  char 


inter  to  char 


inter  to  char 


int 


inter  to  char 


inter  to  char 


inter  to  char 


int 


int 


int 


int 


inter  to  char 


inter  to  char 


int 


lltS 

irs 

ins 


ins 

ins 

irs 


irs 


Where  Tvpedef  Declared 


Sec.  2. 1.4. 1.3  fioheader.h 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


otandard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Function 


create  dphdr 


fio  insert  info 


Calls 


Where  Described 


Sec.  2.1. 4.2.3  4 


Sec.  2.1. 4  2.3.6 


Function 


init  loaoer  for  copvin 


loaqer  start 


Called  B 


Where  Described 


Sec.  2.2.2  2.7 


Sec.  2.2.2.2.29 


Table  2.1-23:  fio  file  header  Information. 
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2. 1.4. 2. 3. 4  create_dphdr 


This  routine  combines  the  passed  arguments  to  form  an  ASCII  string  suitable  for  u^  as  a 
DataProbe  label  (reference  DataProbe  manual).  Note  that  according  to  the  version  8.0 
manual,  <Mily  the  following  fields  are  used  by  DataProbe:  tape  type,  run  number, 
frame  size,  header  size,  time  of  launch,  and  tape  number  (tape  files  only).  This 
procedure  perfoms  error  checking,  and  the  label  is  cleared  out  to  the  passed  length. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

dp  header 

pointer  to  char 

Standard 

pointer  to  char 

Standard 

run  number 

int 

Standard 

project  id 

pointer  to  char 

Standard 

comment 

pointer  to  char 

Standard 

date  of  run 

pointer  to  char 

Standard 

tape  number 

int 

Standard 

bits  per  word 

int 

Standard 

frame  size 

int 

Standard 

header  size 

int 

Standard 

date  of  copy 

pointer  to  char 

Standard 

time  of  run 

pointer  to  char 

Standard 

time  of  launch 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

field  strinqri321 

char 

Standard 

error  string 

pointer  to  char 

Standard 

Iptr 

pointer  to  char 

Standard 

i 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

constoict.dphdr 

Sec.  2.1. 4.2  3.5 

1  Called  By  1 

Function 

Where  Described 

fio  file  header 

Sec.  2.1. 4.2.3  3 

Table  2.1-24:  create_dpiidr  Information. 
2. 1.4. 2. 3. 5  construct_dphdr 


This  routine  adds  a  field  to  a  DataProbe  label.  The  string  to  be  -wnwexi,  field  string,  is 
copied  to  field.  If  fieldstring  is  longer  than  the  maximum  number  of  characters  allowed  in 
the  field,  max  JkldJength,  it  is  truncated  and  a  warning  message  is  printed.  The  item  is 
left  justified  in  its  field  if  the  argument  l^t  Justify  is  TRUE,  and  right  justified  if 
l^t Justify  islrMJSE. 
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1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

error  strina 

pointer  to  char 

Standard 

max  field  lenoth 

int 

Standard 

field 

pointer  to  char 

Standard 

field  strina 

pointer  to  char 

Standard 

left  justify 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

strina  lenath 

int 

Standard 

1  Errors  I 

Error 

Reason  for  Error 

error_string 

If  field_string  exceeds  max_field_length, 
fi0ld_string  is  truncated  and  a  warning 
message  (field is  too  long  for  DataProbe  label) 
is  printed. 

1  Called  By  I 

Function 

Where  Described 

create  dohdr 

Sec.  2.1.4.2.3.4 

set  tape  number  fiohdr 

Sec.  2.1.4.2.3.16 

Table  2.1*25:  construct^dphdr  Information. 


2. 1.4. 2. 3. 6  fio_insert_info 

fio_insert  jnfoO  inserts  a  new  field  specified  by  keyword  in  the  user  info  buffer  of  the 
fio_header  specified  hy  file _hdr.  The  user_info  field  of  the  fio_header  allows  the  user  to 
store  user-defined  information  in  the  fio_header.  The  user  info  buffer  consists  of  a  series 
of  fields  each  having  the  following  format: 


keyword_name 

ifo_bytes 

info... 

char 

short 

char 

The  following  procedures  (Sections  2.1.4.2.3.6-10)  are  provided  to  manipulate  the 
user_info  portion  of  the  fio_header. 


Parameter 


file  hdr 


info 


info  bytes 


Parameters 


e 


inter  to  fio  header 


inter  to  char 


inter  to  char 


short 


Where  Tynedef  Declared 


Sec.  2. 1.4. 1.2  fioheader.h 


Standard 


Standard 


Standard 
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Internal  Variables 


Variable 


tr 


kevlen 


retval 


Where  Typedef  Declared 


Standard 


Standard 


Standard 


Standard 


Return  Values 


Return  Value 


retval 


Meanin 


if  retval  =  FIO_ERROR,  the 
procedure  failed; 
if  retval  =  FIO_OK,  the 
procedure  was  successful 


Error 


FIO_HEADER_INFO_BYTES_FULL_ERROR 


FIO_HEADER_DUPLICATE_KEYWORD_ 

ERROR 


Errors 


Reason  for  Error 


There  is  not  enough  room  in  the  header  for  the 
specified  information 


The  specified  keyword  is  already  in  the  header. 


Function 


find  info 


Calls 


Where  Described 


Sec.  2.1.4.2.3.8 


Function 


fio  convert  header 


fio  file  header 


set  fileid  fiohdr 


set  command  fiohdr 


disk  close 


Called  B 


Where  Described 


Sec.  2.1.4.2.3.2 


Sec.  2.1.4.2.3.3 


Sec.  2.1.4.2.3.11 


Sec.  2.1.4.2.3.13 


Sec.  2.1.4.2.10  .21 


Table  2.1-26:  fio_insert_info  Information. 

2. 1.4. 2. 3. 7  info_field_bytes 

This  routine  returns  the  length  in  bytes  of  the  info  field  pointed  to  by  fldptr. 


Parameters 


Parameter 


fidptr 


IE37^ 

rs 


inter  to  char 


Where  Typedef  Declared 


Standard 


Internal  Variables 


Variable 


info  bvtes 


kevlen 


Where  Typedef  Declared 


Standard 


Standard 


Return  Values 


Return  Value 


keylen  +  sizeof{short)  + 
info  bvtes 


Meanin 


The  length  of  the  info  field 
pointed  to  bv  fldotr 
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Called  B' 


Function 

Where  Described 

fio  delete  info 

Sec.  2.1.4.2.3.9 

find  info 

Sec.  2.1. 4  2.3.8 

Table  2.1-27:  info_field_bytes  Information. 
2. 1.4. 2. 3. 8  find  info 


This  routine  finds  a  field  keyword  in  the  user  info  buffer  of  the  fio_header,/j/e_Wr,  and 
returns  a  pointer  to  it,  ptr. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

file  hdr 

pointer  to  fio  header 

Sec.  2.1. 4.1. 3  fioheader.h 

keyword 

pointer  to  char 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

ptr 

pointer  to  char 

Standard 

ui  end 

pointer  to  char 

Standard 

1  Return  Values  1 

Return  Value 

Meanina 

ptr 

pointer  to  char 

The  pointer  to  the  specified 
field  in  the  user  info  buffer  is 
returned. 

NULL 

pointer  to  char 

The  field  is  null 

i  Calls  1 

Function 

Where  Described 

info  field  bytes 

Sec.  2.1.4.2.3.7 

1  Called  By  1 

Function 

Where  Described 

fio  insert  info 

Sec.  2.1.4.2.3.6 

fio  delete  info 

Sec.  2.1. 4.2  3.9 

fio  retrieve  info 

Sec.  2.1.4.2:3.10 

Table  2.1<28:  find_info  Information. 
2. 1.4. 2. 3. 9  fio  delete  info 


This  routine  deletes  the  field  specified  by  keywork  from  the  user  info  buffer  in  file  hdr.. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

file  hdr 

pointer  to  fio  header 

Sec.  2. 1.4. 1.3  fioheader.h 

keyword 

pointer  to  char 

Standard 
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Variable 


s 


t 


nbvtes 


fldbvtes 


retval 


Internal  Variables 


inter  to  char 


inter  to  char 


Where  Typedef  Declared 


Standard 


Standard 


Standard 


Standard 


Standard 


Return  Value 


retval 


Return  Values 


Meanin 


if  retval  =  FIO_OK,  the 
procedure  was  successful; 
If  retval  -  FIO_ERROR,  the 
procedure  failed 


Errors 


Error  Reason  for  Error 


FIO_HEADER_KEYWORD_NOT_FOUND_  The  specified  keyword  cannot  be  found  in  the 
ERROR  header 


Function 


find  info 


info  field  bvtes 


Calls 


Where  Described 


Sec.  2.1.4.2.3.8 


Sec.  2.1.4.2.3.7 


Called  B 


Function 

Where  Described 

set  fileid  fiohdr 

Sec.  2.1.4.2.3.11 

Table  2.1-29:  flo_delete_info  Information. 

2.1.4.2.3.10  fio_retrieve_info 

This  routine  searches  for  the  field  keyword  in  the  user  info  buffer  of file  hdr,  and  returns  a 
pointer  to  it. 


Parameter 


file  hdr 


info 


info  bvtes 


Parameters 


Where  Typedef  Declared 


inter  to  fio  header  Sec.  2.1 .4.1 .3  fioheader.h 


inter  to  char  Standard 


inter  to  pointer  to  char  Standard 


inter  to  short  Standard 


Variable 


tr 


retval 


Internal  Variables 


inter  to  char 


Where  Typedef  Declared 


Standard 


Standard 
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Return  Value 


retval 


Return  Values 


Meanin 


if  retval  =  FIO_OK,  the 
procedure  was  successful 
if  retval  =  FIO_ERROR,  the 
procedure  failed. 


Errors 


Error  i  Reason  for  Error 


FIO_HEADER_KEYWORD_NOT_FOUND_  The  specified  keyword  cannot  be  found  in  the 
ERROR  header 


Function 


find  info 


Calls 


Where  Described 


Sec.  2.1.4.2.3.8 


Function 


et  fileid  fiohdr 


et  command  fiohdr 


fio  print  fiohdr 


disk  open 


Called  B 


Where  Described 


Sec.  2.1.4.2.3.12 


Sec.  2.1.4.2.3.14 


Sec.  2.1.4.2.3.22 


Sec.  2.1.4.2.10.5 


Table  2.1>30:  fio_retrieve_info  Information. 

The  following  procedures  (Sections  2.1.4.2,3.11-21)  are  convenience  functions  for  getting 
and  setting  standard  fields  in  the  fio_header. 

2.1.4.2.3.11  set  fileid  Hohdr 


This  routine  sets  the  file  id  keyword  of  the  specified  fio_header,^/e_/u/r.  The  file  id  is 
the  name  of  the  data  file. 


Parameters 

Parameter 

Where  Tvpedef  Declared 

file  hdr 

pointer  to  fio  header 

Sec.  2. 1.4.1. 3  fioheader.h 

file  id 

pointer  to  char 

Standard 

Internal  Variables 


Variable 

Type 

Where  Typedef  Declared 

retval 

int 

Standard 

Return  Value 
FIO  OK  


Return  Values 


Meaning  _ 

The  procedure  was  successful 


Errors 


Error 

Reason  for  Error 

FIO  HEADER  DUPLICATE  KEYWORD 

The  specified  keyword  is  already  in  the  header 

ERROR 

FIO  HEADER  KEYWORD  NOT  FOUND 

The  specified  keyword  cannot  be  found  in  the 

ERROR 

header 
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1  Calls  1 

Function 

Where  Described 

fio  insert  info 

Sec.  2.1.4.2.3.6 

fio  delete  info 

Sec.  2.1.4.2.3.9 

fio  error 

Sec.  2.1.4.2.4.1 

Table  2.1-31:  set  fileid  fiohdr  Information. 


2.1.4.2.3.12  get_fileid_fiohdr 

This  procedure  gets  the  file  id  keywwd  field  of  die  specified  fio_header,^te_Adr.  The 
file  id  is  the  name  of  the  data  file. 


Parameter 


file  hdr 


\n 


Parameters 


inter  to  fio  header 


Where  Tvoedef  Declared 


Sec.  2. 1.4.1 .3  fioheader.h 


Variable 


retval 


info 


info  bytes 


Internal  Variables 


IE2T] 

m 
irs 


int 


inter  to  char 


short 


Where  Tvoedef  Declared 


Standard 


Standard 


Standard 


Return  Value 


info 


Return  Values 


lEin 


pointer  to  char 


Meanin 


The  tt/e/d  keyword  field  of  the 
specified  fio  header 


Errors 


Error  Reason  for  Error 


FIO_HEADER_KEYWORD_NOT_FOUND_  The  specified  keyword  cannot  be  found  in  the 
ERROR  header 


Function 


fio  retrieve  info 


Calls 


Where  Described 


Sec.  2.1.4.2.3.10 


Function 


fio  print  fiohdr 


init  lOQQer  for  copvin 


Called  B 


Where  Described 


Sec.  2.1.4.2.3.22 


Sec.  2.2.2.2.7 


Table  2.1-32:  get_fileid_fiohdr. 
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2.1.4.2.3.13  set_coinmand_fiohdr 

This  routine  sets  the  command  keyword  field  of  the  specified  fio_headeT,  file  hdr.  The 
command  is  the  the  UNDC  command  used  to  create  the  data  file. 


Parameter 


file  hdr 


command 


Parameters 


inter  to  fio  header 


inter  to  char 


Where  Typedef  Declared 


Sec.  2.1 .4.1 .3  fioheader.h 


Standard 


Variable 


retval 


Internal  Variables 


Where  Tvoedef  Declared 


Standard 


Return  Value 


FIO  OK 


Return  Values 


Meanin 


The  orocedure  was  successful 


Errors 


Reason  for  Error 


The  specified  keyword  is  already  in  the  header 


Error 


FIO_HEADER_DUPLICATE_KEYWORD_ 

ERROR 


FIO_HEADER_KEYWORD_NOT_FOUND_  I  The  specified  keyword  cannot  be  found  in  the 


ERROR 


header 


Function 


fio  insert  info 


fio  delete  info 


fio  error 


Calls 


Where  Described 


Sec.  2.1. 4.2  3.6 


Sec.  2.1.4.2.3.9 


Sec.  2.1.4.2.4.1 


Table  2.1-33:  set_command_fiohdr  Information. 
2.1.4.2.3.14  get_command_fiohdr 

This  routine  gets  the  command  keyword  of  the  specified  fio_header,  The 

command  is  the  the  UNIX  command  used  to  create  the  data  file. 


Parameter 


file  hdr 


Parameters 


inter  to  fio  header 


Where  Tvoedef  Declared 


Sec.  2.1. 4.1 .3  fioheader.h 


Variable 


retval 


info 


info  bytes 


Internal  Variables 


int 


inter  to  char 


short 


Where  Tvoedef  Declared 


Standard 


Standard 


Standard 


Return  Value 


info 


Return  Values 


pointer  to  char 


Meanin 


The  COMMAND  keyword  field 
of  the  specified  fio  header 
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1  Errors  1 

Error 

Reason  for  Error 

FIO  HEADER  KEYWORD  NOT  FOUND 
ERROR 

The  specified  keyword  cannot  be  found  in  the 
header 

Calls 

Function 

Where  Described 

fio  retrieve  info 

Sec.  2.1.4.2.3.10 

Called  Bv 

Function 

Where  Described 

fio  print  fiohdr 

Sec.  2.1.4.2.3.22 

Table  2.1-34:  get_coininand_fiohdr  Information. 


2.1.4.2.3.15  get_start_date_fiohdr 

This  procedure  returns  the  start  date  of  the  specified  fio_header  in  date  str.  The  start  date 
is  the  date  the  exercise  was  recorded. 


Parameters 


Parameter 

Where  Typedef  Declared 

file  hdr 

pointer  to  fio  header 

Sec.  2.1. 4. 1.3  fioheader.h 

date  str 

pointer  to  char 

Standard 

Varitbie 


tr 


Internal  variables 


inter  to  char 


Where  Typedef  Declared 


Standard 


Function 


er  start 


Called  By _ 

_ Where  Described 

Sec.  2.2.2.2.29 


Table  2.1-35:  get_start_date_nohdr  Information. 
2.1.4.2.3.16  set_tape_number_fiohdr 

This  file  sets  the  tape  number  of  the  specified  fio_header, /i/e  Adr.  The  tape  number  is 
the  volume  number  of  this  file  or  tape  reel  within  the  larger  logical  data  file. 
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I  Calls  I 

Function 

Where  Described 

construct  dphdr 

Sec.  2.1.4.2.3.5 

1 - 

1  Called  Bv 

Function 

Where  Described 

write  controller 

Sec.  2.1.4.2.10.14 

write  controller 

Sec.  2.1.4.2.14.28 

Table  2.1<36:  set_tape_number_fiohdr  Information. 


2.1.4.2.3.17  get_tape_number_fiohdr 

This  procedure  returns  the  tape  number  of  the  specified  fio_header,/ite_/idr.  The 
tape  nuniber  is  the  volume  number  of  this  file  or  t^  reel  within  the  larger  logical  data 
file. 


Parameter 


file  hdr 


irs 


Parameters 


inter  to  fio  header 


Where  Tvoedef  Declared 


Sec.  2. 1.4.1. 3  fioheader.h 


Variable 


tr 


field  strin 


tape  number 


Internal  Variables 


inter  to  char 


char 


int 


Where  TvDedef  Declared 


Standard 


Standard 


Standard 


Return  Value 


tape_number 


IDT? 


Return  Values 


l.'.fT-l.lTlT. 


The  t^e  number  of  the 
specified  header 


Called  B 


Function 

Where  Described 

read  controller 

Sec.  2.1.4.2.10.10 

disk  open 

Sec.  2.1.4.2.10.5 

tape  open 

Sec.  2.1.4.2.14.16 

read  ast  handler 

Sec.  2.1.4.2.14.23 

tvolume  available 

Sec.  2.1.4.2.14.32 

tvolume  starttime 

Sec.  2.1.4.2.14.33 

Table  2.1>37:  get_tape_number_riohdr  Information. 
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2.1.4.2.3.18  set_fraine_size_flohdr 

This  procedure  sets  the  frame  size  of  the  specified  fio_header,^/e_Ad!r.  The  frame  size  is 
the  data  probe  firame  size. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

file  hdr 

pointer  to  fio  header 

Sec.  2.1. 4.1. 3  fioheader.h 

frame  size 

int 

Standard 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

dp  ptr 

pointer  to  char 

Standard 

error  strina 

pointer  to  char 

Standard 

field  strinari321 

char 

Standard 

Calls 

Function 

Where  Described 

construct  dphdr 

Sec.  2.1.4.2.3.5 

Called  By 

Function 

Where  Described 

fio  convert  header 

Sec.  2.1.4.2.3.2 

Table  2.1o38:  set_frame_size_fiohdr  Information. 
2.1.4.2.3.19  get__start_time_riohdr 

This  procedure  points  to  the  start_time  of  the  specified  fio_header  in  time  str.  The 
start  date  is  the  date  the  exercise  was  recorded. 


I 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

file  hdr 

pointer  to  fio  header 

Sec.  2.1. 4.1. 3  fioheader.h 

time  str 

pointer  to  char 

Standard 

Internal 

Variables 

Variable 

Where  Typedef  Declared 

dp  ptr 

pointer  to  char 

Standard 

1  Called  By  I 

■  Function 

Where  Described 

II '  1 1  li  II  liW^—i 1 

Sec.  2.2.2.2.29 

Table  2.1>39:  get_start_time_fiohdr  Information. 
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2.1.4.2.3.20  set  version  chksum  fiohdr 


This  procedure  sets  the  versionjchksum  of  the  specified  fio_header,^/c_/idr.  The 
version  chksum  is  the  checksum  identifying  which  version  of  the  libfio  was  used  to  create 
this  data  file. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

file  hdr 

pointer  to  fio  header 

Sec.  2. 1.4.1. 3  fioheader.h 

version  chksum 

int 

Standard 

Called  Bv 

Function 

Where  Described 

tape  open 

Sec.  2.1.4.2.14.16 

Table  2.1-40:  set_version_cliksum_fiohdr  Information. 
2.1.4.2.3.21  get_version_chksum_f  iohdr 

This  procedure  returns  the  fiolibjyersion  chksum  of  the  specified  fio_header,/j/e_/idr. 
The  version  chkswn  is  the  checksum  identifying  which  version  of  the  libfio  was  used  to 
create  this  data  file. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

file  hdr 

pointer  to  fio  header 

Sec.  2.1. 4.1. 3  fioheader.h 

1  Return  Values  1 

Return  Value 

Meaning 

file_hdr-> 

fiolib_version_chksum 

int 

The  version  chksum  of  the 
specified  fio.header  is 
returned 

1  Called  Bv  1 

Function 

Where  Described 

disk  open 

Sec.  2.1.4.2.10  .5 

read  controller 

Sec.  2.1.4.2.10.10 

read  ast  handler 

Sec.  2.1.4.2.14.23 

tvolume  available 

Sec.  2.1.4.2.14.32 

tvolume  starttime 

Sec.  2.1.4.2.14.33 

Table  2.1-41:  get_version_chksum_fiohdr  Information. 
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2.1.4.2.3.22  fio_print_fiohdr 

This  procedure  prints  the  following  fields  frOTi  the  specified  fio_header,/Z/e_/idr: 

SIMNET  data  file  header  info 
File  Name 
Exercise  ID's 

Project  ID 
Comment 
Date  of  Run 
Time  of  Run 
Volume  Number 

Qxnmand  String 
Looping  mode  tof 
FioUb  Version 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

file  hdr 

pointer  to  fio  header 

Sec.  2. 1.4. 1.3  fioheader.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

bufferfDP  HEADER  BYTES! 

char 

Standard 

Dtr 

pointer  to  char 

Standard 

i 

int 

Standard 

Size 

short 

Standard 

tapenum 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

aet  fileid  fiohdr 

Sec.  2.1.4.2.3.12 

fio  retrieve  info 

Sec.  2.1.4.2.3.10 

aet  command  fiohdr 

Sec.  2.1.4.2.3.14 

1  Called  By  1 

1  Function 

Where  Described 

Sec.  2.2.2.2.29 

Unit  loqqer  for  copvinq 

Sec.  2.2.2.2  7 

Table  2.1-42: 
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2.1.4.2.3.23  null  fiohdr 


This  procedure  sets  the  specified  fio_header,)l/e_/tdr,  to  NULL. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

file  hdr 

pointer  to  fio  header 

Sec.  2.1. 4.1 .3  fioheader.h 

Called  By 

Function 

Where  Described 

init  loQQer  variables 

Sec.  2.2.2.2  toQoer.c 

disk  open 

Sec.  2.1.4.2.10  fiodisk.c 

Table  2.1-43:  null  fiohdr. 


The  file  "error.c"  includes; 
<stdio.h> 
"fioerror.h" 


External  ptxx%dure  declarations: 

perrorO 

errnoO 


Variable  declarations; 
fio_err 

err_msgs[NUM_nO_ERRORS+l] 

sys_errlist[] 

2. 1.4. 2. 4.1  fio  error 


This  routine  prints  out  the  error  message  for  the  last  error  logged  in  fio_err. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared  I 

msQ 

pointer  to  char 

Standard  1 

1  Calls  1 

Function 

Where  Described 

fio  error  strinq 

Sec.  2.1.4.2.4.2 
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1  Called  Bv  1 

Function 

Where  Described 

set  fileid  fiohdr 

Sec.  2.1.4.2.3.11 

set  command  fiohdr 

Sec.  2.1.4.2.3.13 

fiofite  records 

Sec.  2.1.4.2.10.3 

read  dbuffer 

Sec.  2.1.4.2.10.9 

read  controller 

Sec.  2.1.4.2.10.10 

write  dbufter 

Sec.  2.1.4.2.10.13 

write  controller 

Sec.  2.1.4.2.10.14 

disk  seek 

Sec.  2.1.4.2.10.15 

volume  starttime 

Sec.  2.1.4.2.10.17 

volume  endtime 

Sec.  2.1.4.2.10.18 

disk  close 

Sec.  2.1.4.2.10.21 

fnet  open 

Sec.  2.1.4.2.10.2 

tnet  write 

Sec.  2.1.4.2.10.4 

eotv  phase  action 

Sec.  2.1.4.2.14.3 

ini  tbufters 

Sec.  2.1.4.2.14.12 

tape  open 

Sec.  2.1.4.2.14.16 

tape  concat 

Sec.  2.1.4.2.14.17 

read  fiofile  header 

Sec.  2.1.4.2.14.19 

read  tbutter 

Sec.  2.1.4.2.14.20 

read  stream 

Sec.  2.1.4.2.14.21 

read  controller 

Sec.  2.1.4.2.14.22 

read  ast  handler 

Sec.  2.1.4.2.14.23 

write  tiofile  header 

Sec.  2.1.4.2.14.25 

write  stream 

Sec.  2.1.4.2.14.27 

write  controller 

Sec.  2.1.4.2.14.28 

write  ast  handler 

Sec.  2.1.4.2.14.29 

tape  seek 

Sec.  2.1.4.2.14.30 

tvolume  available 

Sec.  2.1.4.2.14.32 

tvolume  starttime 

Sec.  2.1.4.2.14.33 

backup  past  tarqet 

Sec.  2.1.4.2.14.34 

logger  init  cmc 

Sec.  2.2.2.2.11 

logger  put  remote  rtc 

Sec.  2.2.2.2.14 

Table  2.1-44:  fio_error  Information. 

2. 1.4. 2. 4. 2  fio_error_string 

fio_error_string()  returns  the  error  message  string  for  the  last  error  logged  in  fio_err. 
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1  Return  Values  1 

Return  Value 

Meaning 

msgbuf 

char 

1  he  error  message  string  in 
error  msqffio  errl 

1  Called  Bv  1 

Function 

Where  Described 

open  error  strino 

Sec.  2.2.2  2  loqqer.c  (macro  detinition) 

loqqer  .playback  state 

Sec.  2.2.2.2.18 

loqqer  record  state 

Sec.  2.2.2.2.19 

fio  error 

Sec.  2.1.4.2.4.1 

Table  2.1-45:  flo_error_string  Information. 

2. 1.4. 2. 5  fiocvt.h 

This  file  declares  the  procedure,  cvt_fio_packet(),  defined  in  "fiocvt.c". 

2>1.4.2.6  fiocvt.c 

This  file  is  used  in  converting  files  recorded  using  old  versions  of  libfio. 

Includes: 

<stdio.h> 

<ermo.h> 

<sys/types.h> 

"network.h” 

"fiolib.h" 

"fiofile.h" 

Typedefs: 

FIO_PACKET_HEADER_V2  fio_packet_header_v2 

FIO_PACKET_V2  fio_packet_v2 

Define: 

nO_PACKET_SIZE_V2 

2. 1.4. 2. 6.1  cvt_fio_packet 

This  procedure  convens  an  input  fio_packet,  inpkt,  from  the  Version2  to  the  latest  format 
and  points  to  the  packet  in  oi^kt. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

flaqs 

int 

Standard 

outpkt 

pointer  to  fio  packet 

Sec.  2. 1.4. 1.1  fiolib.h 

inpkt 

pointer  to  char 

Standard 

1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

pkt 

pointer  to  fio  packet  v2 

Sec.  2. 1.4.2. 6  fiocvt.c 
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Calls 


_ Called  B _ 

Table  2.1-46:  cvt_fio_pkl  Information. 

2. 1.4. 2. 6. 2  fio_packet_size 

This  procedure  returns  the  fio  j)acket_size  of  the  specified  fio_packet,  pkt. 


Function 
disk  read 
tape  concat 


Where  Described 

Sec.  2.1.4.2.10.7 
Sec.  2.1.4.2.14.17 


Where  Described _ 

Sec.  2.1. 4.1.1  fiolib.h  (macro  definition! 
Sec.  2.1. 4.1.1  fiolib.h  (macro  definition' 


Function _ 

IS  VERSION _ 

COPY  FIO  PACKET 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

flaps 

int 

Standard 

pkt 

pointer  to  fio  packet 

Sec.  2. 1.4. 1.1  fiolib.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

retval 

int 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

retval 

int 

retval  equals  the  size  of  the 
fio  packet 

Errors 

Error 

Reason  for  Error 

MAX_FIO_PACKET_SIZE 

The  fio_packet  exceeds  the  maximum 
aibwable  size 

Calls 

Function 

Where  Described 

IS  VERSION1 

Sec.  2.1.4.1.1  fiolib.h  (macro  definition) 

IS  VERSION2 

Sec.  2.1. 4.1.1  fiolib.h  (macro  definition) 

FIO  PACKET  SIZE  V2 

Sec.  2.1. 4.2.6  fiocvt.c  (macro  definition) 

FIO  PACKET  SIZE 

Sec.  2.1. 4. 1.1  fiolib.h  (macro  definition) 

Table  2.1-47:  no_packet_size  Information. 
2. 1.4. 2. 7  fioutil.b 


This  file  declares  the  following  procedures  defined  in  "fioutil.c": 
fio_alloc() 
fio~free() 
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2. 1.4. 2. 8  fioutil.c 


These  files  ctHitain  low  level  utilities. 


Standard  procedure  declarations: 
mallocO 
free() 

2. 1.4. 2. 8.1  fio_alloc 

This  procedure  allocates  and  initializes  to  zero  a  block  of  memory  by  using  Standard 
proc^ure  malloc(). 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

num 

unsioned 

Standard 

size 

unsigned 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

M 

pointer  to  char 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

ptr 

pointer  to  char 

ptr  points  to  the  allocated 
block  of  memory 

1  Called  Bv  1 

Function 

Where  Described 

disk  open 

Sec.  2.1.4.2.10.5 

fnet  open 

Sec.  2.1.4.2.12.2 

new  tba 

Sec.  2.1.4.2.14.7 

ini  tbuffers 

Sec.  2.1.4.2.14.12 

tape  open 

Sec.  2.1.4.2.14.16 

Table  2.1-48:  rio_alloc  Information. 

2. 1.4. 2. 8. 2  fiojree 

This  procedure  frees  a  block  of  memory  using  Standard  procedure  free(). 


i  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

ptr 

pointer  to  char 

Standard 
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1  Called  Bv  1 

Function 

Where  Described 

disk  close 

Sec.  2.1.4.2.10.21 

fnet  open 

Sec.  2.1.4.2.12.2 

tape  open 

Sec.  2.1.4.2.14.16 

tape  close 

Sec.  2.1.4.2.14.36 

write  controller 

Sec.  2.1.4.2.14.28 

Table  2.1<49:  fio_free  Information. 

2. 1.4. 2.9  fiodisk.h 

This  file  declares  the  procedural  entry  points  for  ini_disk(),  disk_open(), 

disk_concat(),  disk_read(),  disk_write(),  disk_seek(),  and  disk_close(). 

2.1.4.2.10  fiodisk.c 

The  file  "fiodisk.c"  contains  the  procedures  used  to  handle  disk  based  SIMNET  data  files. 

Includes; 

Standard  libraries: 

<stdio.h> 

<ermo.h> 

<fcntl.h> 

<unistd.h> 

<sys/types.h> 

<sys/stat.h> 

<ustat.h> 
fio  files: 

"fiolib.h" 

"fiocvt.h" 

"fioerror.h" 

"fiofile.h" 

"fioheader.h" 

"fioutU.h" 

"fiodisk.h" 

Constant  and  Macro  defines: 

MAX_DISK_VOLUMES 

DISK.MODE 

MAX_nO_RECORDS 

DISKINFO_PTR() 

CONTIGUOUSO 

VOLUME_UFD() 

READ_BYTES() 

Typedefs: 

LINT_T  lint_t 

nO_DISK_FILE  disk_t 
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External  procedure  declarations; 

IseekO 

Static  procedure  declarations: 
next_disk  volumeO 
open^UNlX_disk_file() 
fiofile_records() 
fio_record_endtime() 
read_dp_d bufferO 
read'dbufferO 
read'controllerO 
write_dp_dbuffer() 
write_dbuffer() 
write”controller() 

The  routines  for  writing  input  Bo_packets  from  fio_files  are  called  from  the  "fiolib.c" 
routine  fio_write().  fio^write()  calls  the  disk  routine  disk_write()  to  write  a  single 
data  packeUnto  a  buffer  .""When  the  buffer  is  ff  lied,  the  routine  write  dbufferQ  is  c^led 
to  write  the  full  buffer  of  fiojjackets  to  the  specified  disk-based  data  file.  If  the  disk  file  is 
full,  the  routine  write_controller()  is  called  to  change  the  current  disk  file  volume. 

The  routines  for  reading  input  fio_packets  from  fio_files  are  called  from  the  "fiolib.c" 
routine  fio_read() .  fio_read()  calls  the  disk  routine  disk_read().  disk_read()  reads 
a  single  data  packet  from'the  current  buffer.  When  the  disk  buffer  is  empty,  the  routine 
read_dbufO  is  called  to  read  another  buffer  of  fioj)ackets.  When  the  end  of  volume  is 
reacH^,  the  routine  read_controller()  is  called  to  change  the  cvurent  disk  file  volume. 

2.1.4.2.10.1  next_disk_volume 

This  procedure  returns  a  TRUE  if  there  is  a  next  volume  for  the  disk  file /^ptr  and  a 
FALSE  if  the  current  volume  is  the  last  volume.  The  index  of  the  next  disk  volume  is 
pointed  to  by  ufd. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

fdptr 

fio  file  p 

Sec.  2.1. 4.1.1  fiofile.h 

ufd 

pointer  to  int 

Standard 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

dptr 

pointer  to  disk  t 

Standard 

Return  Values 

Return  Value 

Type 

Meanina 

TRUE 

BOOL 

There  is  a  next  volume  for  this 
disk  file 

FALSE 

BOOL 

This  is  the  last  volume  for  this 
disk  file 

Calls 

Function 

Where  Described 

DISKINFO  PTR 

Sec.  2.1.4.2.10  fiodisk.c  (macro  definition) 

IS  LOOPING 

Sec.  2.1 .4.1 .1  fiolib.h  (macro  definition) 
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Called  B 


Function 

Where  Described 

read  controller 

Sec.  2.1.4.2.10.10 

write  controller 

Sec.  2.1.4.2.10.14 

Table  2.1-50:  next  disk  volume  Information. 


2.1.4.2.10.2  open_UNIX_disk_file 


This  routine  t^ns  the  UNDC  disk  file  specified  in  path  and  returns  its  UNDC  file  descriptor 
in  ufd. 


Table  2.1-51:  open_UNIX_disk_volume  Information. 
2.1.4.2.10.3  fiofile  records 


This  routine  returns  the  number  of  fio_records  for  the  file  specified  in  path. 
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Return  Values 


Return  Value 


retval 


Meanln 


The  number  of  fio_records  for 
this  file.  If  this  value  exceeds 
the  max  value,  an  error  is 
returned. 


Error 


FIO  WARNING  ERROR 


Errors 


Reason  for  Error 


fiolib  error;  exceeded  the  max  number  of 
records  for  this  file. 


Function 


fio  error 


Calls 


Where  Described 


Sec.  2.1.4.2.2.2 


Called  B 


Function 

Where  Described 

disk  open 

Sec.  2.1.4.2.10.5 

disk.  CO  neat 

Sec.  2.1.4.2.10.6 

Table  2.1-52:  fiofiie  records  Information. 


2.1.4.2.10.4  ini_disk 

This  routine  initializes  the  disk  package.  This  function  does  not  take  any  parameters,  does 
not  return  any  values,  does  not  make  any  calls,  and  does  not  generate  any  errors. 


1  Called  Bv  1 

Function 

Where  Described 

ini  fiolib 

Sec.  2.1.4.2.2.13 

Table  2.1-53:  ini  disk  Information. 


2.1.4.2.10.5  disk_open 

This  routine  opens  a  disk  file  for  reading  or  writing.  disk_open()  is  able  to  handle  file 
flags  for  previous  versions  of  the  fio_file  data  format.  ” 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

fdptr 

fio  file  p 

Sec.  2.1. 4.1.1  fiofile.h 

path 

pointer  to  char 

Standard 

size 

unsianed  Iona 

Standard 

header 

pointer  to  fio  header 

Sec.  2.1. 4.1. 2  fioheader.h 
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Variable 


ufd 


curr  fd 


retval 


tr 


curloc 


s 


ace 


I* 


Internal  Variables 


inter  to  reoister  disk  t 


I  int 


I  int 


i  int 


I  Dointertochar 


Where  Tvoedef  Declared 


Sec.  2.1.4.2.10  fiodisk.c 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Sec.  2.1.4.2.10  fiodisk.c 


Return  Values 


Return  Value 


retval 


FIO_OPEN_UNIX_ERROR 


FIO_ALLCX)_UNIX_ERROR 


FIO  VERSION2  ERROR 


Meanln 


if  retval »  FIO_OK,  the 
procedure  was  successful; 
if  retval  =  disk_close(fdptr),  the 
procedure  has  failed  and 
closed  the  disk  file 


procedure  failed  and  disk  file  is 
closed 


procedure  failed  and  disk  file  is 
closed 


procedure  failed  and  disk  file  is 
closed 


Errors 

Error 

Reason  for  Error 

FIO_OPEN_UNIX_ERROR 

Unable  to  open  specified  file  due  to  a  UNIX 
error. 

FIO  ALLOC  UNIX  ERROR 

Unable  to  allocate  space  forfiolib  buffers. 

FIO  WARNING  ERROR 

Unable  to  lock  in  disk  buffer. 

FIO_VERSION1_ERROR 

This  fio  file  volume  has  an  invalid  version  ID 
(Version  1) 

FIO_VERSION2_ERROR 

This  fio  volume  has  an  invalid  version  ID 
(Version  2) 

FIO  SEEK  UNIX  ERROR 

Disk  open;  Seek  to  loqical  bolf 
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Calls 

Function 

Where  Described 

open  UNIX  disk  file 

Sec.  2.1.4.2.10.2 

fio  alloc 

Sec.  2.1.4.2.8.1 

DISKINFO  PTR 


fiofile  records 


CONTIGUOUS 


disk  close 


IS  READABLE 


IS  VERSION1 


IS  VERSION2 


read  fiofile  header 


COPY  FIOHDR 


et  version  chksum  fiohdr 


fio  retrieve  info 


VOLUME  UFD 


null  fiohdr 


read  dbuffer 


wnte  fiofile  header 


FIO  RECORD  PACKETS 


et  tape  number  fiohdr 


Sec.  2.1.4.2.10  fiodisk.c 


Sec.  2.1.4.2.10.3 


Sec.  2.1.4.2.10  fiodisk.c  (macro  definition 


Sec.  2.1.4.2.10.21 


Sec.  2.1.4.1.1  fiolib.h  (macro  definition 


Sec.  2. 1.4. 1.1  fiolib.h  (macro  definition 


Sec.  2.1 .4.1.1  fiolib.h  (macro  definition 


Sec.  2.1.4.2.10.8 


Sec.  2.1. 4.1. 3  fioheader.h  (macro  definition 


Sec.  2.1. 4.2.2  .21 


Sec.  2.1.4.2.3.10 


Sec.  2.1.4.2.10  fiodisk.c  (macro  definition 


Sec.  2.1.4.2.3.23 


Sec.  2.1.4.2.10.9 


Sec.  2.1.4.2.10.12 


Sec.  2.1. 4.1.1  fiofile.h  (macro  definition 


Sec.  2.1.4.2.3.17 


Table  2.1-54:  dtsk_open  Information. 

2.1.4.2.10.6  di$k_concat 

This  routine  concatenates  the  disk  file  specified  by  path  to  the  previously  opened  disk  file 
specified  by  fdptr.  The  procedure  checks  for  consistency;  disk  files  may  only  be 
concatenate  to  other  disk  files.  This  procedure  is  able  to  handle  file  flags  for  previous 
versions  of  the  fio_file  data  format. 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

FIO  OK 

int 

Procedure  was  successful 

FIO  LOOPING  CONCAT 
ERROR 

int 

Procedure  failed;  disk  files 
cannot  be  concatenated  when 
in  LCXDPING  mode 

FIO  MAX  VOLUMES 

ERROR 

int 

Procedure  failed;  maximum 
number  of  file  volumes 
exceeded 

FIO_OPEN_UNIX_ERROR 

int 

Procedure  failed  due  to  a  UNIX 
OPEN  error 

Errors 

Error 

Reason  for  Error 

FIO_OPEN_UNIX_ERROR 

Unable  to  open  specified  file  due  to  a  UNIX 
error. 

FIO  ALLOC  UNIX  ERROR 

Unable  to  allocate  s>jace  for  fiolib  buffers. 

FIO  WARNING  ERROR 

Unable  to  lock  in  dis  k  buffer. 

FIO_VERSION1_ERROR 

This  fio  file  volume  has  an  invalid  version  ID 
(Version  1) 

FIO_VERSION2_ERROR 

This  fio  volume  has  an  invalid  version  10 
(Version  2) 

FIO  SEEK  UNIX  ERROR 

Seek  to  loqical  bolf  error 

Calls 

Function 

Where  Described 

IS  LOOPING 

Sec.  2.1 .4.1.1  fiolib.h  (macro  definition) 

DISKINFO  PTR 

Sec.  2.1.4.2.10  fiodisk.c  (macro  definition) 

open  UNIX  disk  file 

Sec.  2.1.4.2.10.2 

fiofile  records 

Sec.  2.1.4.2.10.3 

Called  By 

Function 

Where  Described 

fio_concat 

Sec.  2.1.4.2.2.6 

Table  2.1-55:  disk  concat  Information. 


2.1.4.2.10.7  disk_read 

disk_read  reads  one  data  packet  from  the  specified  fio_file.  The  user  can  get  either  a 
pointer  to  the  packet  or  a  copy  of  the  packet  by  using  the  copy  argument.  If  the  proper 
open  flags  have  been  used,  the  packet  will  be  ccMiverted  to  the  latest  format  before  being 
returned.  This  routine  is  called  fiom  the  "fiolib.c"  routine  fio  read. 


Parameter 


fdotr 


pkt 


Parameters 


fio  file 


pointer  to  pointer  to 
fio  oacket 


BOOL 


Where  Tvoedef  Declared 


Sec.  2.1. 4.1.1  fiofile.h 


Sec.  2. 1.4. 1.1  fiolib.h 


Standard 
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variable 


status 


cvt_buffer 

[MAX  FIO  PACKET  SIZ 


Internal  Variables 


inter  to  register  disk  t 


int 


static  char 


Where  Typedef  Declared 


Sec.  2.1.4.2.10  fiodisk.c 


Standard 


Standard 


Return  Values 


Return  Value 


status 


Meanin 


if  status  =  FIO_OK,  the 
procedure  was  successful; 
if  status  =  an  error  message, 
the  procedure  failed 


Function 


DISKINFO  PTR 


read  dbuffer 


IS  VERSION 


cvt  fio  packet 


FIO  PACKET  PTR 


Calls 


Where  Described 


Sec.  2.1.4.2.10  fiodisk.c  (macro  definition 


Sec.  2.1.4.2.10.9 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.1.4.2.6.1 


Sec.  2.1. 4.2.2  fiolib.c  (macro  definition 


Called  B 


Function 

Where  Described 

fio  read 

Sec.  2.1.4.2.2.7 

Table  2.1*56:  disk^read  Information. 

2.1.4.2.10.8  read_fiofiie_header 

read_fionie_header  reads  the  fioflle_header  from  the  specified  fio  file.  This  procedure 
is  able  to  handle  file  flags  for  previous  versions  of  the  fio_file  data  format 
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Table  2.1-57:  read_fioflle_header  Information. 

2.1.4.2.10.9  read_dbuffer 

read_dbufrer  reads  a  full  fio_record  of  fio_packets  into  a  disk  buffer.  This  procedure  is 
able  to  handle  file  flag*;  for  previous  versions  of  the  fio_file  data  formaL  This  routine  is 
called  by  disk_read()  when  the  current  disk  buffer  is  exhausted. 


Parameters 


Parameter 


Where  Tvoedef  Declared 


Sec.  2.1. 4.1.1  fiofile.h 


Internal  Variables 


Variable 


curloc 


retval 


Where  Tvoedef  Declared 


Sec.  2  1.4.2.10  fiodisk.c 


Standard 


Standard 


Standard 


Standard 


Standard 


Return  Values 


Return  Value 


FIO  OK 


FIO  VERSION1  ERROR 


Meanin 


Procedure  was  successful. 


Procedure  failed. 


Error 


FIO  EOF  ERROR 


Errors 


Reason  for  Error 


End  of  file  reached. 


Function 


DISKINFO  PTR 


VOLUME  UFD 


IS  LOOPING 


FIO  RECORD  PACKETS 


FIO  RECORD  BYTE  COUNT 


read  controller 


fio  error 


Calls 


Where  Described 


Sec.  2.1.4.2.10  fiodisk.c  (macro  definition 


Sec.  2.1.4.2.10  fiodisk.c  (macro  definition 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.1. 4.1.1  fiofile.h  (macro  definition 


Sec.  2.1. 4.1.1  fiofile.h  (macro  definition 


Sec.  2.1.4.2.10.10 


Sec.  2.1.4.2.4.1 
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1  Called  By  1 

Function 

Where  Described 

disk  open 

Sec.  2.1.4.2.10.5 

disk  read 

Sec.  2.1.4.2.10.7 

Table  2.1-58:  read  dbuffer  Information. 


2.1.4.2.10.10  read_controller 

read  controller  changes  the  cunent  disk  file  volume.  This  procedure  is  able  to  handle 
file  flags  for  previous  versions  of  the  fio_file  data  formaL  This  routine  is  called  by 
read_dbufrer()  when  the  current  volume  is  depleted. 


Parameter 


IE271! 


e 


fio  file 


Parameters 


Where  Typedef  Declared 


Sec.  2.1. 4.1.1  fiofile.h 


Variable 


header 


dfd 


ufd 


volume  number 


cuiioc 


retval 


Internal  Variables 


e 


inter  to  reoister  disk  t 


inter  to  fio  header 


Where  Typedef  Declared 


Sec.  2.1.4.2.10  fiodisk.c 


Sec.  2.1. 4.1. 3  fioheader.h 


Standard 


Standard 


Standard 


Standard 


Standard 


Return  Value 


FIO  OK 


retval 


lEnn 


Return  Values 


Meanin 


Procedure  was  successful 


if  retval  =  0,  the  procedure  was 
successful; 

if  retval  =  an  error  code,  the 
procedure  failed 


Errors 

Error 

Reason  for  Error 

FIO  SEEK  UNIX  ERROR 

Read  controller:  seek  to  first  dbuffer 

FIO  VERSION2  ERROR 

lonorino  tape  volume  with  invalid  format 

FIO  VERSION1  ERROR 

Iqnoring  tape  volume  with  invalid  forniat 

FIO  WARNING  ERROR 

Volume  is  out  of  sequence 

FIO  EOV  ERROR 

End  of  Volume 

FIO  EOF  ERROR 

End  of  File 
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Function 


DISKINFO  PTR 


IS  LOOPING 


VOLUME  UFD 


next  disk  volume 


IS  VERSION1 


read  fiofile  header 


et  version  chksum  ftohdr 


IS  VERSION2 


et  tape  number  fiohdr 


fio  error 


Calls 


Where  Described 


Sec.  2.1.4.2.10  fiodisk.c  (macro  definition 


Sec.  2.1. 4.1.1  fioKb.h  (macro  definition 


Sec.  2.1.4.2.10  fiodisk.c  (macro  definition 


Sec.  2.1.4.2.10.1 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.1.4.2.10.8 


Sec.  2.1.4.2.3.21 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.1.4.2.3.17 


Sec.  2.1.4.2.4.1 


Called  B 


Function 

Where  Described 

read  dbuffer 

Sec.  2.1.4.2.10.9 

Table  2.1-59:  read_controIIer  Information. 

2.1.4.2.10.11  disk_write 

disk_write  writes  an  fio_packet,  pkt,  from  a  specified  fio_file,  to  a  buffer,  dptr.  This 
routine  calls  write_dbuffer().  This  routine  is  cdled  from  the  rest  of  the  DataLogger  code 
through  the  "libfio.c"  routine  fio_write(). 


Parameter 


fdptr 


kt 


Parameters 


e 


fio  file 


inter  to  fio  packet 


Where  Typedef  Declared 


Sec.  2.1. 4.1.1  fiofile.h 


Sec.  2.1. 4.1.1  fiolib.h 


Variable 


status 


Internal  Variables 


e 


inter  to  disk  t 


Where  Typedef  Declared 


Sec.  2.1.4.2.10  fiodisk.c 


Standard 


Return  Values 


Return  Value 


status 


Meanin 


if  status  =  FIO_OK,  the 
procedure  was  successful; 
if  status  »  an  error  code,  the 
procedure  failed 


Function 


DISKINFO  PTR 


FIO  PACKET  SIZE 


write  dbuffer 


FIO  RECORD  PACKETS 


COPY  FIO  PACKET 


Calls 


Where  Described 


Sec.  2.1.4.2.10  fiodisk.c  (macro  definition 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.1.4.2.10.13 


Sec.  2.1. 4.1.1  fiofile.h  (macro  definition 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 
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1  Called  By  1 

Function 

Where  Described 

fio  write 

Sec.  2.1.4.2.2.8 

Table  2.1<60:  disk_write  Information. 
2.1.4.2.10.12  wri  te_fiofile_header 
This  routine  writes  out  the  fiofile  headerto  the  specified  data  file. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

fdptr 

fio  file  p 

Sec.  2.1. 4.1.1  fiofile. h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

dptr 

pointer  to  disk  t 

Sec.  2.1.4.2.10  fiodisk.c 

ufd 

int 

Standard 

hbytes 

unsigned 

Standard 

1  Return  Values  I 

Return  Value 

Type 

Meaninp 

FIO  OK 

int 

Procedure  was  successful 

FIO  WRITE  UNIX  ERROR 

int 

Procedure  failed 

1  Errors  I 

Error 

Reason  for  Error 

FIO  WRITE  UNIX  ERROR 

Write  failed  due  to  UNIX  error. 

1  Calls  1 

Function 

Where  Described 

DISKINFO  PTR 

Sec.  2.1.4.2.10  fiodisk.c  (macro  definition) 

VOLUME  UFD 

Sec.  2.1.4.2.10  fiodisk.c  (macro  definition) 

CONTIGUOUS 

Sec.  2.1.4.2.10  fiodisk.c  (macro  definition) 

1  Called  Bv  1 

Function 

Where  Described 

write  controller 

Sec.  2.1.4.2.10.14 

disk  close 

Sec.  2.1.4.2.10.21 

disk  open 

Sec.  2.1.4.2.10.5 

Table  2.1>61:  write_fionie_header  Information. 
2.1.4.2.10.13  write_dbuffer 

This  routine  writes  a  full  disk  buffer  of  fio_packets  to  a  disk  data  file.  This  routine  is  called 
by  disk_write()  when  the  current  disk  buffer  is  full. 
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Parameters 


Parameter 


fdDtr 


e 


fio  file 


Where  Typedef  Declared 


Sec.  2.1. 4.1.1  fiofile.h 


Internal  Variables 


Variable 


ufd 


nbvtes 


retval 


Where  Tvoedef  Declared 


Sec.  2.1.4.2.10  fiodisk.c 


Standard 


Standard 


Standard 


Return  Values 


Return  Value 


retval 


Meanin 


H  retval  =  FIO_OK,  the 
procedure  was  successful; 
It  retval  =  an  error  code,  the 
procedure  failed 


Error 


EFBIG 


FIO  INTERNAL  ERROR 


FIO  EOF  ERROR 


FIO  WRITE  UNIX  ERROR 


Errors 


Reason  for  Error 


UNIX  error 


Premature  end  of  continuous  file 


End  of  file 


Write  failed  due  to  UNIX  error 


Function 


DISKINFO  PTR 


FIO  RECORD  PACKETS 


FIO  RECORD  BYTE  COUNT 


VOLUME  UFD 


write  controller 


CONTIGUOUS 


fio  error 


Calls 


Where  Described 


Sec.  2.1.4.2.10  fiodisk.c  (macro  definition 


Sec.  2.1. 4.1.1  fiofile.h  (macro  definition 


Sec.  2.1. 4.1.1  fiofile.h  (macro  definition 


Sec.  2.1.4.2.10  fiodisk.c  (macro  definition 


Sec.  2.1.4.2.10.14 


Sec.  2.1.4.2.10  fiodisk.c  (macro  definition 


Sec.  2.1.4.2.4.1 


Called  B 


Function 

Where  Described 

disk  write 

Sec.  2.1.4.2.10.11 

disk  close 

Sec.  2.1.4.2.10.21 

2.1.4.2.10.14 


Table  2.1-62:  write_dbuffer  Information, 
write  controller 


write_controller()  changes  the  current  disk  file  volume.  This  routine  is  called  by 
write_dbuffer()  when  the  current  volume  is  full. 
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Parameters 


Parameter 


e 


fio  file 


Where  Tvoedef  Declared 


Sec.  2.1. 4.1.1  fiofile.h 


Variable 


did 


ufd 


curloc 


retval 


Internal  Variables 


e 


inter  to  disk  t 


Where  Tvoedef  Declared 


Sec.  2.1.4.2.10  fiodisk.c 


Standard 


Standard 


Standard 


Standard 


Return  Values 


Return  Value 


retval 


FIO  EOV  ERROR 


Meanin 


If  retval  =  FIO_OK,  the 
procedure  was  successful; 
If  retval  =  an  error  code,  the 
orocedure  failed 


rocedure  failed 


Error 


FIO  SEEK  UNIX  ERROR 


FIO  EOV  ERROR 


FIO  EOF  ERROR 


Errors 


Reason  for  Error 


Write  controller:  seek  to  first  dbuffer 


End  of  volume 


End  of  file 


Function 


DISKINFO  PTR 


VOLUME  UFD 


IS  LOOPING 


fio  error 


next  disk  volume 


set  tape  number  fiohdr 


write  fiofile  header 


Calls 


Where  Described 


Sec.  2.1.4.2.10  fiodisk.c  (macro  definition 


Sec.  2.1.4.2.10  fiodisk.c  (macro  definition 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.1.4.2.4.1 


Sec.  2.1.4.2.10.1 


Sec.  2.1.4.2.3.16 


Sec.  2.1.4.2.10.12 


Called  B 


Function 

Where  Described 

wide  dbuffer 

Sec.  2.1.4.2.10.13 

Table  2.1-63:  write_controller  Information. 

2.1.4.2.10.15  disk^seek 

disk  seek  seeks  to  a  specified  location  in  a  disk  file.  First  the  time  offset  parameter  is 
translated  into  an  absolute  time  to  seek.  Then  the  routine  checks  to  see  if  the  seek  time  is 
outside  the  beginning  or  end  of  the  file.  If  the  seek  time  is  within  the  fio_file,  the  file 
pointer,  irfd,  is  set  to  the  correct  disk  volume.  Then  the  seek  tries  to  find  the  correct 
packet,  returning  FIO_OK  if  successful  or  an  error  message  if  unsuccessful.  This  routine 
interfaces  with  the  rest  of  the  DataLogger  code  through  the  "libfio.c"  routine  fio_seek(). 
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Parameter 


offset 


whence 


Parameters 


e 


fio  file 


int 


int 


Where  Tvoedef  Declared 


Sec.  2.1 .4.1.1  fiofile.h 


Standard 


Standard 


Variable 


tr 


buffer 


ofs 


ufd 


retvai 


status 


abstirne 


curtime 


startfime 


endtime 


distance 


remainder 


Internal  Variables 


inter  to  disk  t 


inter  to  char 


char 


Where  Typedef  Declared 


Sec.  2.1.4.2.10  fiodisk.c 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Return  Values 


Return  Value 


status 


FIO_SEEK_INVALID_ 
WHENCE  VALUE  ERROR 


FIO_READ_UNIX_ERROR 


FIO  SEEK  UNIX  ERROR 


Meanin 


procedure  failed  due  to  a 
starttime  or  endtime  error 


procedure  was  successful 
(retvai  eauals  FIO  OK) 


procedure  failed  due  to  an 
invalid  whence  parameter 


procedure  failed  due  to  a  UNIX 
READ  error 


procedure  failed  due  to  a  UNIX 
SEEK  error 


Errors 

Error 

Reason  for  Error 

FIO  SEEK  UNIX  ERROR 

Seek  failed  due  to  UNIX  error 

FIO  SEEK  INVALID  WHENCE  VALUE 
ERROR 

Seek  called  with  an  invaid  parameter  for  the 
whence  parameter 

FIO_SEEK_PAST_BOF_ERROR 

Attempting  to  seek  past  the  beginning  of  the 
specified  file 

FIO_SEEK_PAST_EOF_ERROR 

Attempting  to  seek  past  the  end  of  the 
specified  file 

FIOJNTERNAL_ERROR 

•  Distance  of  seek  to  file  end  is  0 
-  Curvol  <  0 

•  Ran  off  the  end  of  the  dbuffer  without  packet. 

FIO  READ  UNIX  ERROR 

Read  failed  due  to  UNIX  error 
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Function 


DISKINFO  PTR 


VOLUME  UFD 


fio  record  endtime 


FIO  PACKET  TIME 


volume  starttime 


volume  endtime 


fio  error 


FIO  RECORD  PACKETS 


FIO  RECORD  BYTE  COUNT 


FIO  PACKET  SIZE 


Calls 


Where  Described 


Sec.  2.1.4.2.10  fiodisk.c  (macro  definition 


Sec.  2.1.4.2.10  fiodisk.c  (macro  definition 


Sec.  2.1.4.2.10.19 


Sec.  2.1 .4.1.1  fiolib.h  (macro  definition 


Sec.  2.1.4.2.10.17 


Sec.  2.1.4.2.10.18 


Sec.  2.1.4.2.4.1 


Sec.  2.1 .4.1.1  fiofile.h  (macro  definition 


Sec.  2.1. 4.1.1  fiofile.h  (macro  definition 


Sec.  2. 1.4. 1.1  fiolib.h  (macro  definition 


Function 


fio  seek 


Called  B 


Where  Described 


Sec.  2.1.4.2.2.9 


Table  2.1-64:  disk  seek  Information. 


2.1.4.2.10.16  disk_seek_time 

disk_seek_time  returns  the  time  stamp  of  the  current  fio_packet. 


Parameter 


fdptr 


IEI73 


e 


fio  file 


Parameters 


Where  Typedef  Declared 


Sec.  2.1. 4.1.1  fiofile.h 


Variable 


Internal  Variables 


inter  to  disk  t 


Where  Typedef  Declared 


Sec.  2.1.4.2.10  fiodisk.c 


Return  Value 


FIO  PACKET  TIME 


DTX 


Return  Values 


Meanin 


the  time  stamp  of  the  specified 
fio  packet 


the  procedure  failed 


Function 


DISKINFO  PTR 


FIO  PACKET  TIME 


Calls 


Where  Described 


Sec.  2.1.4.2.10  fiodisk.c  (macro  definition 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Function 


fio  seek 


Called  B 


Where  Described 


Sec.  2.1.4.2.2.9 


Table  2.1-65:  disk  seek  time  Information. 
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2.1.4.2.10.17  volume  starttime 


This  routine  sets  a  pointer,  time,  to  the  timestamp  of  the  first  fioj)acket  in  the  file  volume 
specified  in  u/d. 


Parameters 


Parameter 


ufd 


time 


inter  to  int 


Internal  Variables 


Where  Tvoedef  Declared 


Standard 


Standard 


!• 


Variable 


tr 


bufferfREAD  BYTES 


Ofs 


oldloc 


inter  to  char 


char 


Where  Tvoedef  Declared 


Standard 


Standard 


Standard 


Standard 


Return  Values 


Return  Value 


FIO  OK 


FIO_SEEK_UNIX_ERROR 


FIO  READ  UNIX  ERROR 


Meanin 


rocedure  was  sucessful 


procedure  tailed  due  to  UNIX 
SEEK  error 


procedure  failed  due  to  UNIX 
READ  error 


Error 


FIO  SEEK  UNIX  ERROR 


FIO  INTERNAL  ERROR 


FIO  READ  UNIX  ERROR 


Errors 


Reason  for  Error 


Procedure  failed  due  to  UNIX  error 


Volume  start  time  <  0 


Procedure  failed  due  to  UNIX  error 


Function 


FIO  RECORD  PACKETS 


FIO  PACKET  TIME 


fio  error 


Calls 


Where  Described 


Sec.  2.1. 4. 1.1  fiofile.h  (macro  definition 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.1.4.2.4.1 


Called  B 


Function 

Where  Described 

disk  seek 

Sec.  2.1.4.2.10  .15 

Table  2.1>66:  volume_starUime  Information. 
2.1.4.2.10.18  volume_endtime 

This  routine  sets  a  pointer,  time,  to  the  timestamp  of  the  last  fio_packet  in  the  file  volume 
specified  in  irfd. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

ufd 

int 

Standard 

inter  to  int 


Standard 
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Variable 


bufferfFlO  RECORD  BYTES 


frcd 


ofs 


oldloc 


newloc 


Internal  Variables 


char 


inter  to  fio  record 


Where  Tvoedef  Declared 


Standard 


Sec.  2.1. 4.1.1  fiofile.h 


Standard 


Standard 


Standard 


Return  Value 


FIO  OK 


FIO_SEEK_UNIX_ERROR 


FIO  READ  UNIX  ERROR 


Return  Values 


Meanin 


re  was  successful 


procedure  failed  due  to  UNIX 
SEEK  error 


procedure  failed  due  to  UNIX 
READ  error 


Error 


FIO  SEEK  UNIX  ERROR 


FIO  INTERNAL  ERROR 


FIO  READ  UNIX  ERROR 


Errors 


Reason  for  Error 


Procedure  failed  due  to  UNIX  error 


Volume  end  time  <  0 


Procedure  failed  due  to  UNIX  error 


Function 


fio  error 


Calls 


Where  Described 


Sec.  2.1.4.2.4.1 


Function 


disk  seek 


Called  B 


Where  Described 


Sec.  2.1.4.2.10.15 


Table  2.1-67:  volume^endtime  Information. 

2.1.4.2.10.19  fio_record_endtime 

This  procedure  sets  a  pointer,  time,  to  the  last  fio_packet  in  the  fio_record  specified  in  frcd. 


Parameter 


frcd 


time 


Parameters 


inter  to  fio  record 


pointer  to  int 


Where  Tvoedef  Declared 


Sec.  2.1. 4.1.1  fiofile.h 


Standard 


Variable 


current  packet 


eo  packets 


kt 


Internal  Variables 


inter  to  char 


inter  to  char 


inter  to  fio  packet 


Where  Tvoedef  Declared 


Standard 


Standard 


Sec.  2. 1.4.1. 1  fiolib.h 
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1  Calls  1 

Function 

Where  Described 

FIO  RECORD  PACKETS 

Sec.  2.1. 4.1.1  fiofile.h  (macro  definition) 

FIO  RECORD  BYTE  COUNT 

Sec.  2.1. 4.1.1  fiofile.h  (macro  definition) 

FIO  PACKET  SIZE 

Sec.  2.1. 4.1.1  fiolib.h  (macro  definition) 

FIO  PACKET  TIME 

Sec.  2.1. 4.1.1  fiolib.h  (macro  definition) 

Called  Bv 

Function 

Where  Described 

disk  seek 

Sec.  2.1.4.2.10.15 

Table  2.1*68:  flo_record_endtiine  Information. 
2.1.4.2.10.20  disk_getrawfd 

This  routine  returns  the  raw  UNDC  file  descriptor  for  the  current  volume  specified  'mfdptr. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

fdptr 

fio  file  p 

Sec.  2.1. 4.1.1  fiofile.h 

vol  offset 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

dptr 

pointer  to  disk  t 

Sec.  2.1.4.2.10  fiodisk.c 

tvol 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

dptr->volume  ufdsftvoll 

pointer  to  disk  t 

The  raw  UNIX  file  descriptor 

1  Calls  1 

Function 

Where  Described 

DISKINFO  PTR 

Sec.  2.1.4.2.10  fiodisk.c  (macro  definition) 

1  Called  By  1 

Function 

Where  Described 

fio  qetrawfd 

Sec.  2.1.4.2.2.10 

fio  flush 

Sec.  2.1.4.2.2.11 

Table  2.1*69:  disk_getrawfd  Information. 

2.1.4.2.10.21  disk_close 

This  routine  closes  the  specified  disk  file.  The  disk  buffer  is  freed,  the  FIO_DISK_FILE  is 
freed,  and  the  header  is  freed.  This  routine  is  called  from  the  rest  of  the  libfio  code  through 
the  fiolib.c  routine  fio_close(). 
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Parameter 


fdotr 


Parameters 


fio  file 


Where  Tyoedef  Declared 


Sec.  2.1 .4.1.1  fiofile.h 


offset 


retval=FIO  OK 


Internal  Variables 


Where  Tvoedef  Declared 


Sec.  2.1.4.2.10  fiodisk.c 


tandard 


Standard 


Standard 


Standard 


Return  Value 


FIO  OK 


FIO_SEEK_UNIX_ERROR 


FIO  READ  UNIX  ERROR 


Return  Values 


Meanin 


rocedure  was  successful 


procedure  failed  due  to  UNIX 
SEEK  error 


procedure  failed  due  to  UNIX 
READ  error 


Error 


FIOJNTERNAL_ERROR 


FIO  CLOSE  UNIX  ERROR 


Errors 


Reason  for  Error 


•  No  room  for  LOOPING  pointer 

•  Write  of  header  failed 


UNIX  CLOSE  error 


Function 


DISKINFO  PTR 


VOLUME  UFD 


IS  WRITABLE 


wnte  dbuffer 


IS  LOOPING 


fio  insert  info 


fio  error 


write  fiofile  header 


fio  free 


Calls 


Where  Described 


Sec.  2.1.4.2.10  fiodisk.c  (macro  definition 


Sec.  2.1.4.2.10  fiodisk.c  (macro  definition 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.1.4.2.10.13 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.1.4.2.3.6 


Sec.  2.1.4.2.4.1 


Sec.  2.1.4.2.10.8 


Sec.  2.1. 4  2.8.2 


Called  B 


Function 

Where  Described 

fio  close 

Sec.  2.1.4.2.2.12 

disk  open 

Sec.  2.1.4.2.10.5 

Table  2.1-70:  disk  close  Information. 
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2.1.4.2.11  fionet.h 

This  file  declares  the  procedural  entry  points  for  ini_fnet(),  fnet_open(),  fnet_read(), 
fnet_write(),  fnet_flush(),  and  fnet_close(). 

2.1.4.2.12  fionet.c 

The  file  "fionetc"  contains  the  procedures  used  to  handle  network  based  SIMNET  data 
files. 

Includes: 

standard  libi^: 

<stdio.h> 
fio  files: 

"fiolib.h" 

"fioerror.h" 

"fiofile.h" 

"fioheader.h" 

"fioutil.h" 

"fionet.h" 

Typedefs: 

LINT_T  Unt_t 

FIO_NET_FILE  fnet_t 

Static  Variable  Declarations: 
errmsg 

Constant  and  Macro  Defines: 

PACKETS_PER_LATE_CHECK 

LATE_MARGIN 

FNETINFO_PTR 

This  file  provides  the  routines  for  SIMNET  (CMC)  Network  based  fio_packet  input/output 
operations.  No  attempt  is  made  to  buffer  fio_packets  being  read  or  written  to  a  network 
file.  Note  that  it  may  be  undesirable  for  an  application  built  on  the  fiolib  to  BLOCK  on 
reads  and  writes.  As  a  result,  NON_BLOCKING  mode  can  be  specified  for  network  files. 

2.1.4.2.12.1  ini_fnet 

This  procedure  initializes  the  fnet  package.  This  procedure  takes  no  parameters,  returns  no 
values,  and  has  no  errors  or  internal  parameters.  ini_fnet()  is  called  from  the  "fiolib.c" 
function  ini_fiolib(). 


1  Called  By  I 

Function 

Where  Described 

ini  fiolib 

Sec.  2.1. 4.2.2  fiolib.c 

Table  2.1-71:  ini  fnet  Information. 
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2.1.4.2.12.2  fnet_open 

This  routine  opens  and  initializes  the  specified  networic  file, 
appropriate  modes. 


Parameter 


ath 


header 


Parameters 


fio  file 


inter  to  char 


inter  to  fio  header 


It  initializes  the  network  in  the 


Where  Typedef  Declared 


Sec.  2.1 .4.2.1  fiofile.h 


Standard 


Sec.  2.1. 4.1.1  fioheader.h 


Variable 


nfd 


scrao  net  address 


e 


Internal  Variables 


e 


inter  to  fnet  t 


mt 


int 


lint  t 


Where  Typedef  Declared 


Sec.  2.1.4.2.12  fionet.c 


Standard 


Standard 


Sec.  2.1.4.2.12  fionet.c 


Return  Values 


Return  Value 


FIO  OK 


FIO  ALLOC  UNIX  ERROR 


FIO  NET  OPEN  ERROR  I  int 


Meanin 


rocedure  was  successful 


procedure  failure  due  to 
inability  to  allocate  space  for 
fiolib  buffers 


procedure  failure  due  to 
inablility  to  open  network 
device  card 


Errors 

Error 

Reason  for  Error 

FIO  NET  OPEN  ERROR 

Unable  to  open  network  device  card 

FIO  ALLOC  UNIX  ERROR 

Unable  to  allocate  space  for  fiolib  buffers 

FIO  WARNING  ERROR 

Unable  to  lockin  network  file  buffer 

FIO  NET  PROMISCUOUS  MODE  ERROR 

Unable  to  activate  promiscuous  mode 

FIO  NET  NORMAL  MODE  ERROR 

Unable  to  activate  normal  mode 

FIO  NET  ALIVE  ERROR 

Network  device  is  not  alive 

FIO_NET_STAMP_ENABLE_ERROR 

Unable  to  enable  timestamping  on  network 
device 

FIO_NET_SETTIME_ERROR 

Unable  to  reset  card  statistics  on  network 
device 

FIO  NET  FLUSH  ERROR 

Unable  to  flush  network  device  rings 

FIO  NET  ZERO  STATISTICS  ERROR 

Unable  to  zero  CMC  card  time 

67 


BBN  Systems  and  Technologies 


Data 


erCSa 


Calls 

Function 

Where  Described 

net  open 

Sec.  2.20.2  in  MCC  CSCI  SDD 

fio  alloc 

Sec.  2.1.4.2.8.1 

fio  error 

Sec.  2.1.4.2.4.1 

FNETINFO  PTR 


FIO  PACKET  PTR 


net  sto 


net  orom 


net  norm 


net  alive 


net  mit  mca 


net  stamp  enable 


net  settime 


net  flush 


Sec.  2.1.4.2.12  fionet.c  (macro  definition 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.20.2  in  MCC  CSCI  SDO 


Sec.  2.20.2  in  MCC  CSCI  SOD 


Sec.  2.20.2  in  MCC  CSCI  SDD 


Sec.  2.20.2  in  MCC  CSCI  SDD 


Sec.  2.20.2  in  MCC  CSCI  SDD 


Sec.  2.20.2  in  MCC  CSCI  SDD 


Sec.  2.20.2  in  MCC  CSCI  SDD 


Sec.  2.20.2  in  MCC  CSCI  SDD 


Table  2.1-72:  fnet_open  Information. 

2.1.4.2.12.3  fnet_read 

The  routine  reads  a  single  PDU  from  the  network  into  an  fiojpacket  along  with  addressing, 
timestamp,  and  type  information.  It  passes  back  either  a  pointer  to  this  fio_packet  or  a 
copy,  depending  on  the  copy  argument.  This  routine  is  called  from  the  rest  of  the 
DataLogger  code  through  fio_read()  in  the  file  "fiolib.c". 


Parameter 


fdptr 


pKt 


Parameters 


e 


fio  file 


pointer  to  pointer  to 
fio  packet 


BOOL 


Where  Typedef  Declared 


Sec.  2.1. 4.2.1  fiofile.h 


Sec.  2. 1.4. 1.1  fiolib.h 


Standard 


Variable 


tr 


Internal  Variables 


e 


cket 


inter  to  fnet  t 


U'i:J 

n 


Where  Tvoedef  Declared 


Sec.  2. 1.4. 1.1  fiolib.h 


Sec.  2.1.4.2.12  fionet.c 


Standard 


Standard 


Standard 


Return  Values 


Return  Value 


retval 


Meanin 


If  retval  -  FIO_OK,  the 
procedure  was  successful: 
If  retval  =  an  error  code,  the 
procedure  failed 


Error 


FIO  NO  PACKETS  AVAIL  ERROR 


Errors 


Reason  for  Error 


No  fio  packets  available  for  read! 
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Function 


FNETINFO  PTR 


IS  NBLOCKING 


net  rev 


net  aet  timestam 


net  aet  rev  from  addr 


net  aet  rev  to  addr 


net  aet  rev  tvoe 


Calls 


Where  Described 


Sec.  2.1.4.2.12  fionet.c  (macro  definition 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.20.2  in  MCC  CSCI SDD 


Sec.  2.20.2  in  MCC  CSCI  SDD 


Sec.  2.20.2  in  MCC  CSCI  SDD 


Sec.  2.20.2  in  MCC  CSCI  SDD 


Sec.  2.20.2  in  MCC  CSCI  SDD 


Called  B 


Function 

Where  Described 

fio  read 

Sec.  2.1.4.2.2.7 

Table  2.1>73:  fnet_read  Information. 

2.1.4.2.12.4  fnet_write 

This  routine  gets  an  fio_packet  and  writes  its  PDU  out  to  the  networic.  Normally,  this 
routine  call  will  block  until  a  packet  is  transmitted,  however,  if  the  file  is  opened  using  the 
FIO_NBLC)CK  flag,  the  call  will  return  immediately.  This  routine  interfaces  with  the  rest 
of  the  Datalogger  code  through  fio_write()  in  the  file  "fiolib.c". 


Parameter 


fdotr 


kt 


Parameters 


e 


fio  file 


inter  to  fio  packet 


Where  Typedef  Declared 


Sec.  2.1. 4.2.1  fiofile.h 


Sec.  2.1. 4.1.1  fiolib.h 


Internal  Variables 


Variable 


nfd 


flaas 


now 


retval 


Where  Typedef  Declared 


Sec.  2.1.4.2.12  fionet.c 


Standard 


Standard 


Standard 


Standard 


Return  Values 


Return  Value 


retval 


Meanin 


If  retval  =  FIO_OK,  the 
procedure  was  successful 
If  retval  equals  an  error 
message,  the  procedure 
failed 


Errors 

Error 

Reason  for  Error 

FIO  INVALID  PACKET  TIMESTAMP 

ERROR 

Invalid  fio _packet  timestamp 

FIO  INVALID  PACKET  SIZE  ERROR 

Invalid  fio  packet  size 

FIO  NET  WRITE  ERROR 

Unable  to  write  packet  to  network  device 

FIO  LATE  PACKET  TO  NET  ERROR 

Late  packet  to  net 
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1  Calls  1 

Function 

Where  Described 

FNETINFO  PTR 

Sec.  2.1.4.2.12  fionet.c  (macro  definition) 

IS  NBLOCKING 

Sec.  2.1. 4.1.1  fiolib.h  (macro  definition) 

fio  error 

Sec.  2.1.4.2.4.1 

net  put  timestamp 

Sec.  2.20.2  in  MCC  CSCI  SDD 

net  set  snd  from  addr 

Sec.  2.20.2  in  MCC  CSCI  SDD 

net  set  snd  type 

Sec.  2.20.2  in  MCC  CSCI  SDD 

net  snd 

Sec.  2.20.2  in  MCC  CSCI  SDD 

net  aettime 

Sec.  2.20.2  in  MCC  CSCI  SDD 

Called  By 

Function 

Where  Described 

fio  write 

Sec.  2.1. 4.2  2.8 

Table  2.1>74:  fnet_write  Information. 


2.1.4.2.12.5  fnet_flush 

This  routine  flushes  the  network  transmit  or  recive  bufter  files.  This  routine  interfaces  with 
the  rest  of  the  DataLogger  code  through  fio_flush  in  the  file  "fiolib.c". 
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Called  B 


Function 

Where  Described 

fio  flush 

Sec.  2.1.4.2.2.11 

Table  2.1-75:  fnet_flush  Information. 
2.1.4.2.12.6  fnet_cIose 

This  routine  closes  the  network  fio_file.  This  routine  interfaces  with  the  rest  of  the 
DataLogger  code  through  fio_close  in  the  file  "fiolib.c". 


Parameter 


fdotr 


lEin 


e 


fio  file 


Parameters 


Where  Tvpedef  Declared 


Sec.  2.1. 4.2.1  fiofile.h 


Internal  Variables 


Variable 


retval 


scrap  net  address 


nfd 


Where  Tyoedef  Declared 


Standard 


Standard 


Standard 


Return  Value 


retval 


IEI7? 


Return  Values 


Meanin 


If  retval  =  FIO_OK,  the 
procedure  was  successful 
If  retval  equals  an  error 
message,  the  procedure 
failed 


Error 


FIO  NET  NORMAL  MODE  ERROR 


FIO  NET  CLOSE  ERROR 


Errors 


Reason  for  Error 


Unable  to  activate  normal  mode 


Unable  to  close  network  device 


Function 


net  sto 


net  norm 


net  close 


Calls 


Where  Described 


Sec.  2.20.2  in  MCC  CSCI  SDD 


Sec.  2.20.2  in  MCC  CSCI  SDD 


Sec.  2.20.2  in  MCC  CSCI  SDD 


Called  B 


Function 

Where  Described 

fio  close 

Sec.  2.1.4.2.2.12 

Table  2.1-76:  fnet_close  Information. 

2.1.4.2.14  fiotape.h 

This  file  declares  the  procedural  entry  points  for  ini_tape(),  tape_open(),  tape_read(), 
tape_write(),  tape_seek(),  and  tape_clos€().  ~ 
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2.1.4.2.14  fiotape.c 


The  key  to  fast  I/O  using  9-track  tape  is  to  keep  the  tape  drive  streaming  as  much  as 
possible.  To  do  this  requires  that  the  t^  records  be  of  ctmstant  size.  Reading  from  and 
writing  to  9-track  tape-based  data  files  requires  that  these  requirements  be  met. 


On  the  MASSCOMP,  streaming  is  handled  using  asynchronous  I/O  via  the  AST 
(Asynchronous  Software  Trap)  which  is  a  proprietary  extension  to  UNIX  in  the 
MASSCOMP  version  of  UNIX  RTU. 


The  "fiotape.c"  routines  make  use  of  the  AST  for  writing  as  follows:  individual 
fio_packets  are  written  into  a  fio_record  buffer  using  c^s  to  tape_write.  When  the 
buffer  is  full  it  is  placed  on  the  end  of  a  list  of  buffers  by  a  call  to  write_buffer.  When 
enough  buffers  arc  full,  write  buffer  calls  write  stream  to  start  the  tape  device 
streaming.  This  is  done  asyncfiionously  using  IOCTL  calls  and  multiple  ASTs. 

The  AST  handler  write_ast  handler  checks  for  error  conditions  and  attempts  to  keep  the 
drive  streaming  if  there  are  sHll  full  buffers  available.  Once  a  particular  tape  volume  (tape 
reel)  has  been  filled,  write_stream  calls  write_controller  to  switch  to  another  volume 
(tape  device,  tape  reel,  or  both). 


The  process  for  reading  from  a  9-track  tape  data  file  is  similar,  except  that  buffers  are  being 
emptied  instead  of  fill^.  Also,  the  limiting  factor  on  the  streaming  is  the  amount  of 
memory  available  for  buffers,  not  the  number  of  full  buffers.  In  exercises  that  have  very 
high  data  rates,  having  sufficient  amounts  of  internal  memory  allows  the  transitions 
between  tape  volumes  (tape  reels)  to  proceed  smoothly. 


Includes: 

standard  libraries: 
<stdio.h> 
<fcntl.h> 
<ermo.h> 
<ast.h> 
<sys/types.h> 
<sys/mtio,h> 
<sys/ioctl.h> 
fio  files: 


"fiolib.h" 

"fiocvt.h" 

"fioerror.h" 

"fiofile.h" 

"fioheader.h 

"fioutil.n' 

"fiotape.h" 


ti 
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Constant  and  Macro  Defines: 

EOTV_PHASE_DELAY 

EOTV_NULL_VOLUME 

NULL_TAPE_NUMBER 

NULL.STARTTIME 

MAX_TAPE_DRIVES 

MAX_TAPE_VOLUMES 

MAX_VOLUME_STARTnME 

TOO_BIG_2MB_5600 

OK_2B_5600_NO_EXCELAN 

OK_2MB_5600 

MAX_BUFFER_MEMORY 

TBUFFERS_PER_600_FOOT_TAPE 

TBUFFERS_PER_1200_FOOT_TAPE 

TBUFFERS_PER_2400_FOOT_TAPE 

TBIJFFERS_PER_TINY 

TBUFFERS_PER_SMALL 

TBUFFERS_PER_VERSIONl_TAPE 

TAPE_READ_THRESHOLD 

MAX_SIMULTANEOUS_OPS 

TOTAL_TBUFFERS 

nO_HEADER_OF_TBUFFER 

nO_RECORD_OF_TBUFFER 

nO_RECORD_STARTnME 

VOLUME_NUMBER 

VOLUME_STARmME 

SET_VOLUME_STARTTIME 

OPS.AVAILABLE 

TBUFS.AVAILABLE 

VOLUME.UFD 

ZYLOGICS_472_EOT_ERROR 

XYLOGICS_472_DRIVE_READY 

XYLOGICS_472_DRIVE_ONLINE 

TAPE_AST_PRIORnY 

DISABLE_AST 

RESTORE_AST 

WAIT_FOR_AST 

MIN 

TAPEINFO.PTR 

QUEUE_COUNT() 

QUEUE_HEAD() 

QUEUE_TAIL() 

Typedefs: 

TBUFFER_Q 
T_BUFFER_T 
L!N1'_T 
EOTV_E 

EOTV_PHASE_E 
LLSTATE_E 
VOLUME_INFO 
nO_TAPE_FILE 


tbuffer_q 

tbuffer_t 

lint_t 

cotv_e 

eotv_phs_e 

llstat_e 

tapevoljnfo 

tape_t 
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Global  Variable  Declarations: 
errmsg 
fTee_tbq 

External  procedure  declarations: 
exitO 

Static  procedure  declarations: 
do_eotv_action() 
iniI_eotv_action() 
eotv_phase_action() 
unix_tape_action() 
promote_^tatus_info() 
is_next_tape_v6iume() 
read_fiofiIe_header() 
read^bufferO 
read_stream() 
read_controlIer() 
read_ast_handler() 
write_fiofile_header() 
write~tbuffeF() 
write_stream() 
write~controller() 
write_ast_handler() 
backup_past_target() 
tvolume_^^tailtime() 
tvolume^availahleO 

The  following  routines  (Sections  2.1.4.2.14.1-3)  handle  the  transitioning  from  one  tape 
volume  on  one  tape  drive  to  another  tape  volume  on  another  tape  drive  in  the  case  of  a 
concatenated  tape  file. 

2.1.4.2.14.1  init_eotv_action 

This  routine  initializes  the  end  of  tape  volume  action,  setting  the  volume,  phase,  and  delay 
characteristics  from  the  input  parameters. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

fdptr 

fio  file  p 

Sec.  2.1. 4.2.1  fiofile.h 

volume 

int 

Standard 

phase 

eotv  phs  e 

Sec.  2.1.4.2.14  fiotape.c 

delay 

int 

Standard 

1  Internal  Variables  1 

[Variable 

Type 

Where  Typedef  Declared 

Imi _ 

1  lliillilli  II II  nil 

Sec.  2.1.4.2.14  fiotape.c 

1  Calls  1 

Function 

Where  Described 

TAPEINFO  PTR 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 
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1  Called  By  1 

Function 

Where  Described 

read  controller 

Sec.  2.1.4.2.14.22 

write  controller 

Sec.  2.1.4.2.14.28 

Table  2.1-77:  init  eotv  action  Information. 


2.1.4.2.14.2  do_eotv_action 

This  perfonns  the  end  of  tape  volume  action.  The  choices  are: 

1)  To  do  nothing 

2)  To  rewind  off-line 

3)  To  rewind  on-line 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

fdotr 

fio  file  p 

Sec.  2.1 .4.2.1  fiofile.h 

delay 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

tptr 

pointer  to  reqister  tape  t 

Sec.  2.1.4.2.14  fiotape.c 

vol 

int 

Standard 

ufd 

int 

Standard 

Dhase 

eotv  phs  e 

Sec.  2.1.4.2.14  fiotape.c 

action 

eotv  e 

Sec.  2.1.4.2.14  fiotape.c 

1  Calls  1 

Function 

Where  Described 

TAPEINFO  PTR 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

VOLUME  UFD 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

eotv  phase  action 

Sec.  2.1.4.2.14  .3 

1  Called  By  1 

Function 

Where  Described 

write  tbuffer 

Sec.  2.1.4.2.14.26 

read  tbuffer 

Sec.  2.1.4.2.14.20 

Table  2.1-78:  do_eotv_action  Information. 

2.1.4.2.14.3  eotv_phase_action 

This  routine  performs  the  action  specified  by  eotv  action  on  the  Unix  file  descriptor 
specified  in  i^d.  Rewinding  the  tape  is  a  phased  action;  since  the  rewind  takes  a  long  time, 
the  action  is  broken  up  into  phases  so  the  tape  streaming  can  ccmtinue.  The  phases  are; 

1)  Backup  a  small  amount 

2)  Write  the  End-of-Tape  maricer 

3)  Execute  the  End-of-Tape  action 

4)  Clear  the  status 
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Parameters 


Parameter 


ufd 


eotv  Dhase 


eotv  action 


int 


eotvDhs  e 


eotv  e 


Where  TvDedef  Declared 


Standard 


Sec.  2.1.4.2.14  fiotaoe.c 


Sec.  2.1.4.2.14  fiotaoe.c 


Internal  Variables 


Variable 


status 


retval 


stnjct  mto 


stmct  mtoet 


eotv  Ohs  e 


Where  Typedef  Declared 


Standard 


Standard 


Sec.  2.1.4.2.14  fiotaoe.c 


Return  Values 


Return  Value 


retval 


eotvj3h_e 


Meanin 


The  End_of_Tape_Volume 
ohase  action. 


Function 


fio  error 


XYLOGICS  472  DRIVE  READY 


eotv  ohase  action 


Calls 


Where  Described 


Sec.  2.1.4.2.4.1 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1.4.2.14.3 


Function 


tvolume  available 


do  eotv  action 


read  controller 


taoe  seek 


write  controller 


tvolume  starttime 


Called  B 


Where  Described 


Sec.  2.1.4.2.14.32 


Sec.  2.1.4.2.14.2 


Sec.  2.1.4.2.14.22 


Sec.  2.1.4.2.14.30 


Sec.  2.1.4.2.14.28 


Sec.  2.1.4.2.14.33 


Table  2.1-79:  eotv_phase_action  Information. 
2.1.4.2.14.4  unix_tape_action 

This  routine  performs  the  specified  action  on  the  specified  Unix  file  descriptor,  ufd. 
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Table  2.1>80:  unix_tape_action  Information. 
2.1.4.2.14.5  promote_status_info 

This  routine  promotes  the  ll.status  to  the  appropriate  hl_status. 


Parameter 


fdotr 


Function 


TAPEINFO  PTR 


Function 


tape  open 


IE213 


Parameters 


e 


fio  file 


Where  Tvoedef  Deciared 


Sec.  2.1. 4.2.1  fiofile.h 


internal  Variables 


Where  Tvoedef  Declared 


Sec.  2.1.4.2.14  fiotape.c 


Calls 


Where  Described 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Called  B 


Where  Described 


Sec.  2.1.4.2.14.16 


Table  2. 1-81 :  promote_status_info  Information. 
2.1.4.2.14.6  is_next_tape_volume 


This  routine  returns  a  pointer  to  the  index  of  the  next  tape  volume  in  vol.  This  routine 
returns  a  TRUE  if  there  is  a  next  volume  for  this  tape  file. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

fdptr 

fio  file  p 

Sec.  2.1. 4.2.1  fiofile.h 

vol 

pointer  to  int 

Standard 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

tptr 

Sec.  2.1.4.2.14  fiotape.c 
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1  Return  Values  1 

Return  Value 

Meanina 

TRUE 

BOOL 

there  is  a  next  tape  volume 

FALSE 

BOOL 

this  is  the  last  tape  volume 

1  Calls  1 

Function 

Where  Described 

TAPEINFO  PTR 

Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition) 

IS  CONTINUOUS 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

1  Called  By  1 

Function 

Where  Described 

write  tbuffer 

Sec.  2.1.4.2.14.26 

write  controller 

Sec.  2.1.4.2.14.28 

write  ast  handler 

Sec.  2.1.4.2.14.29 

read  ast  handler 

Sec.  2.1.4.2.14.23 

read  controller 

Sec.  2.1.4.2.14.22 

read  stream 

Sec.  2.1.4.2.14.21 

Table  2.1-82:  is_next_tape_volume  Information. 

Tape  buffers  and  tape  buffer  queues 

The  following  routines  handle  tape  buffers  so  that  the  tape  device  can  be  kept  streaming. 

2.1.4.2.14.7  new_tbq 

This  routine  allocates  and  initializes  an  empty  tbuffer_q,  tbq. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

space 

lint  t 

Sec.  2.1.4.2.14  fiotape.c 

tbq 

pointer  to  tbuffer  q 

Sec.  2.1.4.2.14  fiotape.c 

1  Return  Values  I 

Return  Value 

Meaninq 

tbq 

pointer  to  tbuffer  q 

a  pointer  to  the  new  tbuffer  q 

1  Calls  1 

Function 

Where  Described 

fio  alloc 

Sec.  2.1.4.2.5.1 

1  Called  By  I 

Function 

Where  Described 

tape  open 

Sec.  2.1.4.2.14.16 

concatjbs 

Sec.  2.1.4.2.14.10 

Table  2.1-83:  new_tbq  Information. 
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2.1.4.2.14.8  enqueue_tb 

This  routine  adds  a  tbuffer,  tbq,  to  the  end  of  a  tbuffer_q  and  sets  a  pointer,  tbirf,  to  the 
number  of  buffers  in  the  list 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvoedef  Declared 

tbq 

pointer  to  tbuffer  a 

Sec.  2.1.4.2.14  fiotape.c 

tbuf 

pointer  to  tbuffer  t 

Sec.  2.1.4.2.14  fiotape.c 

Called  Bv 

Function 

Where  Described 

write  tbuffer 

Sec.  2.1.4.2.14.26 

write  ast  handler 

Sec.  2.1.4.2.14.29 

tape  seek 

Sec.  2.1.4.2.14.30 

tape  concat 

Sec.  2.1.4.2.14.17 

ini  tbuffer 

Sec.  2.1.4.2.14.12 

tape  close 

Sec.  2.1.4.2.14.36 

read  ast  handler 

Sec.  2.1.4.2.14.23 

tape  open 

Sec.  2.1.4.2.14.16 

Table  2.1*84:  enqueue_tb  Information. 

2.1.4.2.14.9  dequeue_tb 

This  routine  removes  a  tbuffer  from  the  head  of  a  tbuffer_q  and  returns  a  pointer  to  the 
former  head  of  the  tbuffer_q. 


Parameters 


Parameter 


Where  Tyoedef  Declared 


Sec.  2.1.4.2.14  fiotape.c 


Variable 


tbuf 


lEiTi: 

irs 


Internal  Variables 


e 


inter  to  tbuffer  t 


Where  Tvoedef  Declared 


Sec.  2.1.4.2.14  fiotape.c 


Return  Value 


tbuf 


Return  Values 


pointer  to  tbuffer_t 


Meanin 


the  former  head  of  the 
tbuffer 


Function 


write  stream 


next  available  tbuffer 


tape  seek 


read  tbuffer 


tape  close 


tape  open 


Called  B 


Where  Described 


Sec.  2.1.4.2.14.27 


Sec.  2.1.4.2.14.13 


Sec.  2.1.4.2.14.30 


Sec.  2.1.4.2.14.20 


Sec.  2.1.4.2.14.36 


Sec.  2.1.4.2.14.16 


Table  2.1-85:  dequeue_tb  Information. 
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2.1.4.2.14.10  concat_tbqs 

This  routine  creates  a  new  tbuffer_q  which  is  the  ctMicatenatitx)  of  the  two  specified 
queues,  tbql  and  tbq2,  and  returns  a  pointer  to  the  new  tape  buffer  queue. 


Parameters 


Parameter 


2 


Where  Tvoedef  Declared 


Sec.  2.1.4.2.14  fiotape.c 


Sec.  2.1.4.2.14  fiotape.c 


Internal  Variables 


Variable 


concat  t 


Where  Tvoedef  Declared 


Sec.  2.1.4.2.14  fiotape.c 


Return  Value 


concatjbq 


Return  Values 


pointer  to  tbuffer_q 


Meanin 


a  pointer  to  the  new, 
concatenated  tape  buffer 
ueue. 


Function 


new  tb 


Calls 


Where  Described 


Sec.  2.1.4.2.14.7 


Called  B 


Function 

Where  Described 

write  controller 

Sec.  2.1.4.2.14.28 

Table  2.1*86:  concat_tbs  Information. 

2.1.4.2.14.11  null_tbq 

This  routine  NULLs  out  the  specified  tape  buffer  queue  by  setting  the  tbq  count  field  to  0 
and  the  tbq  head  and  tail  to  NULL. 


Parameters 


Parameter 


Where  Typedef  Declared 


Sec.  2.1.4.2.14  fiotape.c 


Function 


write  controller 


Called  B 


Where  Described 


Sec.  2.1.4.2.14.28 


Table  2.1-87:  null_tbq  Information. 

2.1.4.2.14.12  ini_tbuffers 

This  routine  initializes  the  tape  buffers  abstraction.  Tape  buffers  are  "locked"  into  memory 
for  performance  reasons.  The  procedure  returns  F10_0K  if  successful  arid  an  error 
message  if  unsuccessful. 
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Variable 


initialized 


lockin  failed 


Internal  Variables 


BOOL 


int 


lint  t 


inter  to  tbuffer  t 


int 


Where  Tvoedef  Declared 


Standard 


Standard 


Sec.  2.1.4.2.14  fiotape  c 


Sec.  2.1.4.2.14  fiotape.c 


Standard 


Return  Values 


Return  Value 


FIO  OK 


FIO  ALLOC  UNIX  ERROR 


FIO  WARNING  ERROR 


Meanin 


dure  was  successful 


rocedure  failed  due  to  error 


rocedure  failed  due  to  error 


Error 


FIO  ALLOC  UNIX  ERROR 


FIO  WARNING  ERROR 


Errors 


Reason  for  Error 


Unable  to  allocate  space  for  fiolib  buffers 


Unable  to  lockin  tape  buffers 


Function 


fio  alloc 


enaueue  tb 


fio  error 


Calls 


Where  Described 


Sec.  2.1.4.2.8.1 


Sec.  2.1.4.2.14.8 


Sec.  2.1.4.2.4.1 


Called  B 


Function 

Where  Described 

tape  open 

Sec.  2.1.4.2.14.16 

2.1.4.2.14.13 


Table  2.1-88:  ini_tbu^ers  Information, 
next  available  tbuffer 


This  routine  gets  and  initializes  an  empty  tbuffer  for  the  specified  fio_file,/c^rr,  from  the 
stash  of  PRIVATE  tbuffers,  or  if  they  are  exhausted,  from  the  free  tbuffer  pool.  A  pointer 
to  an  intialized  tbuffer,  tbif,  if  returned. 
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Return  Value 


tout 


FIO  ALLOC  UNIX  ERROR 


FIO  WARNING  ERROR 


Return  Values 


pointer  to  tbufferj 


Meanin 


the  next  available  initialized 
tbuffer. 


ure  failed  due  to  error 


ure  failed  due  to  error 


Function 


TAPEINFO  PTR 


DISABLE  AST 


OUEUE  COUNT 


dequeue  tb 


IS  READABLE 


RESTORE  AST 


Calls 


Where  Described 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1.4.2.14.9 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.1 .4.2.14  fiotaoe.c  (macro  definition 


Function 


wnte 


read  stream 


Called  B 


Where  Described 


Sec.  2.1.4.2.14.24 


Sec.  2.1.4.2.14.21 


Table  2.1-89:  next_available_tbuffer  Information. 
2.1.4.2.14.14  bytes_to_trcds 

Given  the  tape  size  in  bytes,  this  routine  returns  the  size  in  tbuffers. 


Parameter 


bvtes 


Variable 


retval 


Return  Value 


retval 


Function 


taoe  ooen 


lEin 


unsioned  Ion 


Parameters 


Where  Tvoedef  Declared 


Standard 


Internal  Variables 


e 


Where  Tvoedef  Declared 


Standard 


Return  Values 


Meanin 


the  number  of  tbuffers  in  the 
ictaoe  size 


Called  B 


Where  Described 


Sec.  2.1.4.2.14.16 


Table  2.1-90:  bytes_to_trcds  Information. 
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2.1.4  2.14.15  ini_tape 

This  void  routine  inidalizes  the  tape  package. 


1  Called  By  1 

Function 

Where  Described 

ini  fiolib 

Sec.  2.1.4.2.2.13 

Table  2.1-91:  ini_tape  Information. 


2.1.4.2.14.16  tape_open 

This  routine  opens  a  tape  file  for  reading  or  writing. 


Parameter 


ath 


size 


header 


Parameters 


fio  file 


inter  to  char 


unsianed  Ion 


inter  to  fio  header 


Where  Tvoedef  Declared 


Sec.  2.1. 4.2.1  fiofile.h 


Standard 


Standard 


Sec.  2. 1.4. 1.2  fioheader.h 


Variable 


Internal  Variables 


e 


inter  to  reoister  tape  t 


Where  Tvpedef  Declared 


Sec.  2.1.4.2.14  fiotaoe.c 


inter  to  register  fio  header  I  Sec.  2. 1.4. 1.2  fioheader.h 


ufd 


num  private  tbuffers 


retval 


tbuf 


space 


inter  to  fio  record 


int 


int 


int 


mt 


inter  to  tbuffer  t 


lint  t 


Sec.  2.1. 4.2.1  fiofile.h 


Standard 


Standard 


Standard 


Standard 


Sec.  2.1.4.2.14  fiotape.c 


Sec.  2.1.4.2.14  fiotape.c 


Return  Values 


Return  Value 


retval 


FIO_OPEN_UNIX_ERROR 


FIO  ALLOC  UNIX  ERROR 


FIO  NOT  ASYNCH  ERROR  int 


FIO  OK 


Meanin 


procedure  failed  due  to 
problem  initializino  tbuffers 


procedure  failed  due  toUnix 
OPEN  error 


procedure  failed  due  to 
inability  to  allocate  space  for 
fiolib  buffers 


procedure  failed:  device  does 
not  support  asynchronous  I/O 


rocedure  was  successful 


Error 


FIO  OPEN  UNIX  ERROR 


FIO  ALLOC  UNIX  ERROR 


FIO  NOT  ASYNCH  ERROR 


FIO  WARNING  ERROR 


Errors 


Reason  for  Error 


Unable  to  open  specified  file  due  to  Unix  error 


Unable  to  allocate  space  for  fiolib  buffers 


rt  asynchronous  I/O 


-  Only  some  tape  buffers  ayailable 

-  Unable  to  lockin  file  header  tbuffer 
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Calls 

Function 

Where  Described 

ini  tbuffers 

Sec.  2.1.4.2.14.12 

IS  READABLE 


fio  alloc 


TAPEINFO  PTR 


bytes  to  trcds 


new  tb 


QUEUE  COUNT 


fio  error 


dequeue  tb 


enqueue  tb 


tape  close 


fio  free 


read  fiofile  header 


WAIT  FOR  AST 


remote  status  info 


read  stream 


FIO  RECORD  OF  TBUFFER 


FIO  RECORD  PACKETS 


COPY  FIOHDR 


set  version  chksum  fiohdr 


write  fiofile  header 


VOLUME  NUMBER 


et  tape  number  fiohdr 


Sec.  2.1 .4.1.1  fiolib.h  (macro  definition 


Sec.  2.1.4.2.8.1 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1.4.2.14.14 


Sec.  2.1.4.2.14.7 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1 .4  2.4.1 


Sec.  2.1.4.2.14.9 


Sec.  2.1.4.2.14.8 


Sec.  2.1.4.2.14.36 


Sec.  2.1.4.2.8.2 


Sec.  2.1.4.2.14.19 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1.4.2.14.5 


Sec.  2.1.4.2.14.21 


Sec.  2.1 .4.2.14  fiotape  c  (macro  definition 


Sec.  2.1. 4.2.1  fiofile.h  (macro  definition 


Sec.  2. 1.4. 1.2  fioheader.h  (macro  definition 


Sec.  2.1.4.2.3.20 


Sec.  2.1.4.2.14.25 


Sec.  2.1 .4.2.14  fiotape.c  (macro  definition 


Sec.  2.1.4.2.3.17 


Tabfe  2.1-92:  tape_open  Information. 

2.1.4.2.14.17  tape_concat 

This  routine  concatenates  the  tape  file  specified  in  path  with  the  open  file  specified  in  fdptr, 
checking  for  consistency,  laipe  concat()  is  called  from  the  "fiolib.c"  routine, 
fio_concat().  This  routine  pro^des  the  basis  for  the  dual  tape  logger.  By  concatenating 
two  tape  drives  and  swapping  tape  reels,  the  user  can  create  arbitr^y  long  data  files.  Each 
tape  reel  corresponds  to  a  daaa  file  volume. 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

FIO  OK 

int 

the  procedure  was  successful 

FIO  MAX  VOLUMES 

ERROR 

int 

procedure  failed:  maximum 
number  of  file  volumes 
exceeded 

FIO_OPEN_UNIX_ERROR 

int 

unable  to  open  specified  fiie 
due  to  Unix  error 

Errors 

Error 

Reason  for  Error 

FIO  MAX  VOLUMES  ERROR 

Maximum  number  of  file  volumes  exceeded 

FIO  OPEN  UNIX  ERROR 

Unable  to  open  specified  file  due  to  Unix  error 

Calls 

Function 

Where  Described 

TAPEINFO  PTR 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

IS  READABLE 

Sec.  2.1. 4.1.1  fiolib.h  (macro  definition) 

Called  By 

Function 

Where  Described 

fio  concal 

Sec.  2.1.4.2.2.6 

Table  2.1>93:  tape_concat  Information. 

2.1.4.2.14.18  tape_read 

The  routines  for  reading  input  fio_packets  from  fio_files  are  called  from  the  "fiolib.c" 
routine  fio_read().  fio_read()  calls  the  tape  routine  tape_read()  to  read  input  data 
packets  from  the  specified  fio_fiIe.  The  fio_packets  are  passed  back  to  the  user  one  at  a 
time  until  the  current  tbuffer  has  been  exhausted.  When  there  are  no  more  fio_4)ackets  left 
in  the  current  tbuffer,  read_tbu(Ter()  is  called  to  get  another  full  tbuffer  from  the  linked 
list  of  tbuffers.  If  the  linked  list  of  filled  tbuffers  has  fallen  below  the 
TAPE_READ_THRESHOLD,  the  read_stream()  routine  is  called.  read_stream()  takes 
advantage  of  the  tape  controller's  ability  to  do  multiple  asynchronous  read  operations  and 
reads  a  stream  of  fio_packets  from  the  current  tape  drive  into  the  linked  list  of  tbuffers. 
When  the  end  of  the  tape  volume  is  reached,  read_stream()  calls  read_controner()  to 
swap  tape  volumes.  ~ 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

fdptr 

fio  file  p 

Sec.  2.1. 4.2.1  fiofile.h 

pktptr 

pointer  to  pointer  to 
fio  packet 

Sec.  2. 1.4. 1.1  fiolib.h 

copy 

BOOL 

Standard 

BBN  Systems  and  Technologies 


Data  Logger  CSCl 


Internal  Variables 


Variable 


cvt_buffer 

MAX  FIO  PACKET  SIZE! 


frcd 


tbuf 


nbvtes 


stat 


irsnSHEISJESEF 

irs 
irs 


inter  to  reoister  fio  record 


inter  to  tbuffer  t 


Where  Tvoedef  Declared 


Standard 


Sec.  2.1.4.2.14  fiotape.c 


Sec.  2.1 .4.2.1  fiofile.h 


Sec.  2.1.4.2.14  fiotaoe.c 


Standard 


Standard 


Return  Values 


Return  Value 


stat 


FIO_NO_PACKETS_AVAIL_  int 
ERROR 


Meanin 


if  stat  =  FIO_OK,  the 
procedure  was  successful, 
if  stat  -  an  error  message,  the 
orocedure  failed 


no  fio_packets  available  for 
readin 


Error 


FIO  EOF  ERROR 


FIO_DRIVE_NOT_READY_ERROR 


FIO  NO  PACKETS  AVAIL  ERROR 


FIO  INTERNAL  ERROR 


Errors 


Reason  for  Error 


End  of  File 


Tape  drive  for  continuous  concatenated  file  is 
not  readv 


No  fio  packets  available  for  read! 


Corrupt  fio  record 


Function 


enqueue  tb 


TAPEINFO  PTR 


read  tbuffer 


IS  NBLOCKING 


WAIT  FOR  AST 


IS  VERSION1 


FIO  RECORD  OF  TBUFFER 


FIO  RECORD  BYTE  COUNT 


fio  error 


FIO  RECORD  PACKETS 


cvt  fiooacket 


IS  VERSION 


FIO  PACKET  PTR 


FIO  PACKET  TIME 


Calls 


Where  Described 


Sec.  2.1.4.2.14.8 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1.4.2.14.20 


Sec.  2.1. 4. 1.1  fiolib.h  (macro  definition 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1. 4.2.1  fiofile.h  (macro  definition 


Sec.  2.1.4.2.4.1 


Sec.  2.1. 4.2.1  fiofile.h 


Sec.  2.1.4.2.6.1 


Sec.  2.1.4.1.1  fiolib.h  (macro  definition 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Called  B 


Function 

Where  Described 

fio  read 

Sec.  2.1.4.2.2.7 

Table  2.1-94:  tape_concat  Information. 
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2.1.4.2.14.19 


read  flofile  header 


This  routine  makes  an  asynchronous  lOCTL  call  to  read  in  the  first  tape  record,  which 
contains  the  DataProbe  record  and  the  user  defined  header. 


1  Parameters  1 

Parameter 

Typo 

Where  Typedef  Declared 

fdptr 

fio  file  p 

Sec.  2.1 .4.2.1  fiofile.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

tptr 

pointer  to  reaister  tape  t 

Sec.  2.1.4.2.14  fiotape.c 

tbuf 

pointer  to  tbuffer  t 

Sec.  2.1.4.2.14  fiotape.c 

ufd 

int 

Standard 

ast 

int 

Standard 

Errors 

Error 

Reason  for  Error 

FIO  INTERNAL  ERROR 

Read  fio  fiie  header  error 

Calls 

Function 

Where  Described 

DISABLE  AST 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

TAPEINFO  PTR 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

VOLUME  UFD 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

fio  error 

Sec.  2.1.4.2.4.1 

RESTORE  AST 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

Called  Bv 

Function 

Where  Described 

read  controller 

Sec.  2.1.4.2.14.22 

tape  open 

Sec.  2.1.4.2.14.16 

tape  seek 

Sec.  2.1.4.2.14.30 

Table  2.1-95:  read_fioflle_header  Information. 
2.1.4.2.14.20  read  tbuffer 


This  routine  attempts  to  get  a  full  tbuffer  of  fio_packets.  If  successful,  it  returns  a  pointer 
to  the  tbuffer,  if  it  fails  it  returns  NULL.  If  there  are  less  than 
TAPE_READ_THRESHOLD  tbuffers,  this  routine  calls  read_streamO  to  get  more. 
read_tbuffer()  is  called  from  tape_read()  when  no  more  fio^^ckets  are  in  the  current 
tbuffer.  Note  diat  this  routine  may  Fave  the  effect  of  causing  the  high  level  status  of  the 
tape  file  to  change. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

iSfitr _ 

fio  file  p 

Sec.  2.1. 4.2.1  fiofile.h 
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Variable 


Internal  Variables 


inter  to  reaister  tape  t 


inter  to  tbuffer  t 


Where  Typedef  Declared 


Sec.  2.1.4.2.14  fiotaoe.c 


Sec.  2.1.4.2.14  fiotaoe.c 


Standard 


Return  Value 


tbuf 


Return  Values 


pointer  to  tbuffer_t 


Meanin 


if  four  equals  NULL,  the 
routine  failed; 

otherwise,  fOuf  points  to  the 
full  tbuffer  of  fio  oackets  read 


Error 


FIO  EOV  ERROR 


FIO  INTERNAL  ERROR 


FIO  EOF  ERROR 


FIO  DRIVE  NOT  READY  ERROR 


Errors 


Reason  for  Error 


Erxl  of  file  volume 


11  status 


End  of  file 


Tape  drive  for  continous  concatenated  file  is 
not  read 


Function 


DISABLE  AST 


TAPEINFO  PTR 


QUEUE  COUNT 


dequeue  tb 


fio  error 


do  eotv  action 


read  stream 


RESTORE  AST 


Calls 


Where  Described 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1.4.2.14.9 


Sec.  2.1.4.2.4.1 


Sec.  2.1.4.2.14.2 


Sec.  2.1.4.2.14.21 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Function 


taoe  concat 


taoe  seek 


Called  B 


Where  Described 


Sec.  2.1.4.2.14.17 


Sec.  2.1.4.2.14.30 


Table  2.1-96:  read  tbuffer  Information. 


2.1.4.2.14.21  read_stream 

This  routine  reads  a  stream  of  tbuffers  from  the  current  tape  drive.  It  makes  the  lOCTL 
calls  for  an  asynchronous  tape  read.  Depending  upon  the  fio_file  state,  read_stream() 
makes  a  variable  number  of  lOCTTL  HOAREAD  calls.  read_stream()  is  called  when  the 
linked  list  of  filled  tbuffers  has  fallen  below  the  TAPE_READ_THRESHOLD. 


Parameters 


Parameter 


Where  Tvoedef  Declared 


Sec.  2.1. 4.2.1  fiofile.h 
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Variable 


Internal  Variables 


inter  to  reoistert 


inter  to  tbuffer  t 


num  ops 


Ufa 


ast 


Where  Tvoedef  Declared 


Sec.  2.1.4.2.14  fiotape.c 


Sec.  2.1.4.2.14  fiotape.c 


Standard 


Standard 


Standard 


Standard 


Error 


FIO  INTERNAL  ERROR 


Errors 


Reason  for  Error 


Function 


DISABLE  AST 


TAPEINFO  PTR 


MIN 


TUBFS  AVAILABLE 


next  available  tbuffer 


fio  error 


IS  next  tape  volume 


read  controller 


RESTORE  AST 


Calls 


Where  Described 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1.4.2.14.13 


Sec.  2.1.4.2.4.1 


Sec.  2.1.4.2.14.6 


Sec.  2.1.4.2.14.22 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Called  B 


Function 

Where  Described 

read  tbuffer 

Sec.  2.1.4.2.14.20 

tape  seek 

Sec.  2.1.4.2.14.30 

tape  open 

Sec.  2.1.4.2.14.16 

2.1.4.2.14.22 


Table  2.1*97:  read_stream  Information, 
read  controller 


This  routine  is  called  when  read_stream()  reaches  the  End  of  Tape  Volume. 
read_controller()  attempts  to  switch  tapes.  Once  the  new  tape  volume  is  mounted,  this 
routine  clears  the  drive  status,  allowing  read_stream()  to  continue. 


Parameters 


Where  Tvoedef  Declared 


Sec.  2.1. 4.2.1  fiofile.h 


Variable 


status 


vol 


ufd 


hase 


ast 


Internal  Variables 


struct  mtaet 


int 


int 


eotv  phs  e 


int 


Where  Tvoedef  Declared 


Sec.  2.1.4.2.14  fiotape.c 


Sec.  2.1.4.2.14  fiotape.c 


Standard 


Standard 


Sec.  2.1.4.2.14  fiotape.c 


Standard 
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1  Errors  1 

Error 

Reason  for  Error 

RAW  DRIVE  NOT  READY  ERROR 

FIO_DRIVE_NOT_READY_ERROR 

Tape  drive  for  continuous  concatenated  file  is 
not  ready 

FIO  INTERNAL  ERROR 

No  next  tape  volume 

Calls 

Function 

Where  Described 

DISABLE  AST 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

TAPEINFO  PTR 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

is  next  tape  volume 

Sec.  2.1.4.2.14.6 

XYLOGICS  472  DRIVE  READY 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

init  eotv  action 

Sec.  2.1.4.2.14.1 

read  fiofile  header 

Sec.  2.1.4.2.14.19 

VOLUME  UFD 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

eotv  phase  action 

Sec.  2.1.4.2.14.3 

fio  error 

Sec.  2.1.4.2.4.1 

RESTORE  AST 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

Called  Bv 

Function 

Where  Described 

read  stream 

Sec.  2.1.4.2.14.21 

Table  2.1*98:  read  controller  Information. 


2.1.4.2.14.23  read_ast_handler 

This  routine  is  the  high  level  AST  handler  for  FIOAREADs.  The  AST  handler  determines 
if  the  read  operation  was  successful.  If  it' was,  the  tbuffer  is  freed  to  be  used  again.  If  the 
operation  was  not  successful,  error  status  codes  are  set. 

The  argument  pc  is  the  pc  at  the  start  of  this  function.  The  argument  prio  is  the  priority  of 
the  AST  that  called. 


Parameter 


tbuf 


c 


Parameters 


inter  to  tbuffer  t 


Where  Tvoedef  Declared 


Sec.  2.1.4.2.14  fiotaoe.c 


Standard 


Standard 


Variable 


asvnch 


is  eotv 


fhdr 


frcd 


Internal  Variables 


exter  int 


fio  file 


inter  to  register  tape  t 


inter  to  register  struct  io 


BOOL 


inter  to  fio  header 


inter  to  fio  record 


int 


int 


Where  Tvpedef  Declared 


Standard 


Sec.  2.1. 4.2.1  fiofile.h 


Sec.  2.1.4.2.14  fiotaoe.c 


Standard 


Standard 


Sec.  2. 1.4. 1.2  fioheadcr.h 


Sec.  2.1. 4.2.1  fiofile.h 


Standard 


Standard 
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1  Errors  1 

Error 

Reason  for  Error 

RAW  ABNORMAL  EOV  ERROR 

RAW  ABNORMAL  EOF  ERROR 

FIOJNTERNAL_ERROR 

-  Corrupt  fio_record  ignored 

-  Volume  is  out  of  sequence 

-  Unexpected  End  of  Tape  encountered  while 
readinq  tape  volume 

RAW  EOV  ERROR 

FIO_VERSION1_ERROR 

This  fio  file  volume  has  an  invalid  version  ID 
(Versioni) 

FIO_VERSION2_ERROR 

'Rris  fio  file  volume  has  an  invalid  version  ID 
(Version2) 

I  Calls  I 

Function 

Where  Described 

DISABLE  AST 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

TAPEINFO  PTR 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

IS  VERSION1 

Sec.  2. 1.4. 1.1  fiolib.h  (macro  definition) 

FIO  RECORD  OF  TBUFFER 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

FIO  RECORD  BYTE  COUNT 

Sec.  2.1. 4.2.1  fiofile.h  (macro  definition) 

fio  error 

Sec.  2.1.4.2.4.1 

enqueue  tb 

Sec.  2.1.4.2.14.8 

FIO  HEADER  OF  TBUFFER 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

qet  version  chksum  fiohdr 

Sec.  2.1.4.2.3.21 

is  VERSION2 

Sec.  2.1. 4.1.1  fiolib.h  (macro  definition) 

VOLUME  NUMBER 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

qet  tape  number  fiohdr 

Sec.  2.1.4.2.14.17 

SET  VOLUME  STARTTIME 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

FIO  RECORD  STARTTIME 

Ml  1  1  MW  lilM 

is  next  tape  volume 

Sec.  2.1.4.2.14.6 

QUEUE  COUNT 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

RESTORE  AST 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

Table  2.1-99:  read  ast  handler  Information. 


2.1.4.2.14.24  tape_write 

The  routines  for  writing  input  flo_packets  are  called  from  the  "fiolib.c"  routine 
fio_write().  fio_write()  calls  the  tape  routine  tape_writeO  to  write  fio_packets.  The 
fiolpackets  are  s^ed  in  a  tape  buffer  (tbuffer).  When  the  current  tbuffer  is  filled, 
write  tbufferO  is  called  to  add  the  full  tbuffo'  into  the  linked  list  of  full  tbuffers.  When 
the  TAPE_WRITE_THRESH0LD  of  tbuffers  has  been  reached,  the  write  streamQ 
routine  is  called.  write_stream()  takes  advantage  of  the  tape  controller’s  ability  to  do 
multiple  asynchronous  write  operations  and  writes  a  stream  of  tbuffers  from  the  linked  list 
of  tbuffers  to  the  tape  drive.  If  the  end  of  the  tape  volume  is  reached  during 
write_stream(),  the  write_controllerO  routine  is  called  to  swap  tapes. 


Any  buffers  which  get  filled  while  the  tape  is  streaming  can  be  written  immediately, 
however,  once  the  tape  stops  streaming,  nothing  is  written  until  the 
TAPE_WRITE_TRESH0LD  of  tbuffers  is  reached.  In  addition,  there  are  complications  at 
tape  boundaries  (i.e.  End  of  Tape  error  recovery),  especully  in  the  case  of  continuous  tape 
files. 
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Parameter 


Parameters 


fio  file 


inter  to  fio 


Where  Tvoedef  Declared 


Sec.  2.1. 4.2.1  fiofile.h 


Sec.  2.1. 4.1.1  fiolib.h 


Variable 


frcd 


tbuf 


nbvtes 


size 


stat 


Internal  Variables 


inter  to  reoister  tame  t 


inter  to  fk)  record 


inter  to  tbuffer  t 


Where  Typedef  Declared 


Sec.  2.1.4.2.14  fiotape.c 


Sec.  2.1. 4.2.1  fiofile.h 


Sec.  2.1.4.2.14  fiotaoe.c 


Standard 


Standard 


Standard 


Return  Value 


stat 


Return  Values 


FIO  NO  BUFFERS  ERROR  I  int 


Meanin 


sfaf  is  equal  to  the  high  level 
status;  if  equal  to  FIO_OK, 
then  procedure  was 
successful;  if  equal  to 
FIO_EOF_ERROR.  then 
procedure  failed  due  to  end  of 
file  error. 


procedure  failed;  no  buffers 
available  for  writina 


Errors 

Error 

Reason  for  Error 

FIO  EOF  ERROR 

End  of  file 

FIO  DRIVE  NOT  READY 

Tape  drive  for  continuous  contcatenated  file  is 
not  ready 

FIO  NO  BUFFERS  ERROR 


No  buffers  available  for  wrlti 


Function 


TAPEINFO  PTR 


FIO  PACKET  SIZE 


FIO  RECORD  OF  TBUFFER 


FIO  RECORD  BYTE  COUNT 


wnte  tbuffer 


next  available  tbuffer 


FIO  RECORD  PACKETS 


IS  NBLOCKING 


WAIT  FOR  AST 


write  stream 


Calls 


Where  Described 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1. 4.2.1  fiofile.h  (macro  definition 


Sec.  2.1.4.2.14.26 


Sec.  2.1.4.2.14.13 


Sec.  2.1. 4.2.1  fiofile.h  (macro  definition 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1.4.2.14.27 


Function 


fio  write 


Called  B 


Where  Described 


Sec.  2.1. 4.2  2.8 


Table  2.1>100:  tape_write  Information. 
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2.1.4.2.14.25 


write  fiofile  header 


This  routine  makes  an  asynchronous  ICXITl.  call  to  write  the  DataProbe  record  and  the  user 
defined  header.  The  fio_file  header  should  always  be  the  first  tbuffer  on  a  tape  reel. 


Parameters 


Parameter 


ufd 


Where  Tvoedef  Declared 


Standard 


Variable 


Internal  Variables 


e 


inter  to  reoister  taoe  t 


inter  to  tbuffer  t 


Where  Tynedef  Declared 


Sec.  2.1.4.2.14  fiotape.c 


Sec.  2.1.4.2.14  fiotape.c 


Standard 


Standard 


Error 


FIO  INTERNAL  ERROR 


Errors 


Reason  for  Error 


Write  fio  file  header  error 


Function 


DISABLE  AST 


TAPEINFO  PTR 


VOLUME  UFD 


fio  error 


RESTORE  AST 


Calls 


Where  Described 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1.4.2.4.1 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Called  B 


Function 

Where  Described 

write  controller 

Sec.  2.1.4.2.14.28 

tape  open 

Sec.  2.1.4.2.14.16 

Table  2.1-101:  write_fiofile_header  Information. 
2.1.4.2.14.26  write__tbuffer 

This  routine  puts  a  full  tbuffer  of  fio_packets  into  the  linked  list  of  tbuffers. 
write_tbuffer()  is  called  from  tape_write()  when  the  current  tbuffer  is  filled.  Note  that 
this  routine  may  have  the  effect  of  causing  the  high  level  status  of  the  tape  file  to  change. 


Parameter 


Parameters 


fio  file 


inter  to  tbuffer  t 


Where  Tvpedef  Declared 


Sec.  2.1. 4.2.1  fiofile.h 


Sec.  2.1.4.2.14  fiotape.c 


Variable 


Internal  Variables 


inter  to  reoister  ta 


inter  to  fio  record 


Where  Tvpedef  Declared 


Sec.  2.1.4.2.14  fiotape.c 


Sec.  2.1. 4.2.1  fiofile.h 


Standard 


Standard 
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Errors 

Error 

Reason  for  Error 

FIO  EOV  ERROR 

End  of  fio  file  volume 

RAW  EOV  ERROR 


FIO  EOF  ERROR 


RAW  EOF  ERROR 


Function 


DISABLE  AST 


TAPEINFO  PTR 


FIO  RECORD  OF  TBUFFER 


SET  VOLUME  STARTTIME 


FIO  RECORD  STARTTIME 


enaueue  tb 


do  eotv  action 


IS  next  taoe  volume 


write  stream 


RESTORE  AST 


Calls 


Where 


Sec.  2.1 . 


Sec.  2.1 . 


Sec.  2.1 . 


Sec.  2.1 . 


Sec.  2.1 . 


Sec.  2.1 


Sec.  2.1 


Sec.  2.1 


Sec.  2.1 


Sec.  2.1 . 


Described 


.4.2.14  fiotaoe.c 


.4.2.14  fiotaoe.c 


.4.2.14  fiotaoe.c 


.4.2.14  fiotaoe.c 


.4.2.14  fiotaoe.c 


.4.2.14.8 


.4.2.14.2 


.4.2.14.6 


.4.2.14.27 


.4.2.14  fiotaoe.c 


(macro  definition 


(macro  definition 


(macro  definition 


(macro  definition 


(macro  definition 


(macro  definition 


Function 


write 


taoe  close 


Called  B 


Where  Described 


Sec.  2.1.4.2.14.24 


Sec.  2.1.4.2.14.36 


Table  2.1>102:  write_tbuffer  Information. 

2.1.4.2.14.27  write_stream 

This  routine  writes  a  stream  of  tbuffers  from  the  current  tape  drive.  write_stream() 
makes  a  variable  number  of  lOCTL  FIOA WRITE  calls,  depending  upon  the  state  of  Ae 
tape  file  (e.g.  are  there  any  errors,  is  the  tape  drive  streaming,  how  many  buffers  are  filled, 
and  how  many  write  operations  are  still  pending  from  the  physical  tape  controller). 
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Error 


RAW  EOF  ERROR 


RAW  ABNORMAL  ERROR 


RAW  EOV  ERROR 


RAW  ABNORMAL  EOV  ERROR 


RAW  DRIVE  NOT  READY  ERROR 


FIO  INTERNAL  ERROR 


Errors 


Reason  for  Error 


Write  fio  file  header  error 


Function 


DISABLE  AST 


TAPEINFO  PTR 


MIN 


OUEUE  COUNT 


write  controller 


deoueue  tb 


VOLUME  UFD 


fio  error 


RESTORE  AST 


Calls 


Where 


Sec.  2.1. 


Sec.  2.1. 


Sec.  2.1 . 


Sec.  2.1. 


Sec.  2.1 


Sec.  2.1 


Sec.  2.1 . 


Sec.  2.1 


Sec.  2.1. 


Described 


4.2.14  fiotape.c 


4.2.14  fiotape.c 


4.2.14  fiotape.c 


4.2.14  fiotape.c 


.4.2.14.28 


.4.2.14.9 


4.2.14  fiotape.c 


.4.2.4.1 


4.2.14  fiotape.c 


(macro  definition 


(macro  definition 


(macro  definition 


(macro  definition 


(macro  definition 


(macro  definition 


Function 


write 


write  tbuffer 


tape  close 


write  controller 


Called  B 


Where  Described 


Sec.  2.1.4.2.14.24 


Sec.  2.1.4.2.14.26 


Sec.  2.1.4.2.14.36 


Sec.  2.1.4.2.14.28 


Table  2.1>103:  write  stream  Information. 


2.1.4.2.14.28  write_controller 

This  routine  is  called  to  switch  tapes  when  write_stream()  reaches  the  End  of  Tape 
Volume.  Note  that  the  tapes  cannot  be  switched  until  all  KXrTL  calls  are  returned. 
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Error 


RAW  ABNORMAL  EOV  ERROR 


RAW  DRIVE  NOT  READY  ERROR 


RAW  ABNORMAL  EOF  ERROR 


FIO_DRIVE_NOT_READY_ERROR 


FIO  INTERNAL  ERROR 


FIO  ALLOC  UNIX  ERROR 


Errors 


Reason  for  Error 


Tape  drive  for  continuous  concatenated  file  is 
not  ready 


No  next  tape  volume 


Allocation  error;  lost  packets 


Function 


DISABLE  AST 


TAPEINFO  PTR 


IS  next  taoe  volume 


VOLUME  UFD 


XYLOGICS  472  DRIVE  READY 


init  eotv  action 


OUEUE  COUNT 


concat  tbqs 


fio  free 


fio  error 


VOLUME  NUMBER 


set  tape  number  fiohdr 


wnte  fiofile  header 


write  stream 


eotv  phase  action 


RESTORE  AST 


Calls 


Where 


Sec.  2.1 . 


Sec.  2.1. 


Sec.  2.1 


Sec.  2.1. 


Sec.  2.1 . 


,  Sec.  2.1 


Sec.  2.1. 


Sec.  2.1 


Sec.  2.1 


Sec.  2.1 


Sec.  2.1 


Sec.  2.1. 


Sec.  2.1 


Sec.  2.1 


Sec.  2.1 


Sec.  2.1 


Sec.  2.1. 


Described 


4.2.14  fiotape.c 


4.2.14  fiotape.c 


.4.2.14.6 


4.2.14  fiotape.c 


4.2.14  fiotape.c 


.4.2.14.1 


4.2.14  fiotape.c 


.4.2.14.10 


.2.2.82 


.4.2.14.11 


.4.2.4.1 


4.2.14  fiotape.c 


.4.2.3.16 


.4.2.14.25 


.4.2.14.27 


.4.2.14.3 


4.2.14  fiotape.c 


(macro  definition 


(macro  definition 


(macro  definition 


(macro  definition 


(macro  definition 


(macro  definition 


(macro  definition 


Called  B 


Function 

Where  Described 

write  stream 

Sec.  2.1.4.2.14.27 

Table  2.1-104:  wrhe_controIIer  Information. 

2.1.4.2.14.29  write_ast_liandler 

This  routine  is  the  high  level  AST  handler  for  FIOAWRTTEs.  The  AST  handler  determines 
if  the  write  operation  was  successful.  If  it  was,  the  tbuffer  is  freed  to  be  used  again.  If  the 
operation  was  not  successful,  error  status  codes  are  set. 

The  argument  pc  is  the  pc  at  the  start  of  this  function.  The  argument  prio  is  the  priority  of 
the  AST  that  called. 
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Variable 


errno 


fdotr 


asvnch 


ufd 


ast 


Internal  Variables 


extern  int 


fio  file 


inter  to  reaister  tape  t 


inter  to  reaister  struct  io 


int 


int 


Where  Typedef  Declared 


Standard 


Sec.  2.1. 4.2.1  fiofile.h 


Sec.  2.1.4.2.14  fiotape.c 


Standard 


Standard 


Standard 


Error 


FIO  INTERNAL  ERROR 


Errors 


Reason  for  Error 


-  Unexpected  End  of  Tape  encountered 
while  WRITING  tape  volunie;  or  a  write  error 
due  to  bad  tape 

-  Unexpected  Result;  write  only  partly 
succeeded,  but  there  was  no  error 
messaae. 


Function 


DISABLE  AST 


TAPEINFO  PTR 


enqueue  tb 


fio  error 


is  next  taoe  volume 


RESTORE  AST 


Calls 


Where  Described 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1.4.2.14  fiotape.c  (rr'acro  definition 


Sec.  2.1.4.2.14.8 


Sec.  2.1.4.2.4.1 


Sec.  2.1.4.2.14.6 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Table  2.1-105:  write_ast_handler  Information. 

2.1.4.2.14.30  tape_seek 

This  routine  seeks  to  a  specified  location  in  a  tape  file.  The  seeking  is  accomplished  in 
terms  of  network  time  ticks.  First,  the  time  offset  is  translated  into  an  absolute  exercise 
time.  Then,  a  check  is  made  to  see  that  all  lOCTL  calls  are  returned.  An  attempt  is  made  to 
find  the  volume  on  which  the  seek  time  is  most  likely  to  be  found.  A  check  is  made  to  see 
if  the  volume  is  actually  mounted.  Then,  streaming  is  started.  A  search  is  made  for  the 
correct  buffer,  being  careful  about  reaching  the  End  of  File.  Then,  the  routine  backs  up  to 
an  appropriate  point  to  start  the  seek  forward  (avoiding  backing  up  past  the  fio_header)  and 
checks  for  the  correct  tbuffer. 


Parameters 


Parameter 


fdotr 


offset 


whence 


e 


fio  file 


int 


int 


Where  Typedef  Declared 


Sec.  2.1. 4.2.1  fiofile.h 


Standard 


Standard 
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Where  Tvpedef  Declared 
Sec.  2.1.4.2.14  fiotape.c 
Sec.  2.1.4.2.14  fiotape.c 

Sec.  2.1. 4.2.1  fiofile.h _ 

Standard _ 

Standard _ 

Standard _ 

Standard _ 

Standard _ 

Standard _ 

Standard _ 

Standard _ 

Standard _ 

Standard _ 

Standard _ 

Standard _ 

Standard _ 

Standard _ 

Standard _ 

Standard _ 

Sec.  2.1.4.2.14  fiotape.c 
Sec.  2.1.4.2.14  fiotape.c 


Meaning _ 

the  f»o_seek_end  whence 
value  is  invalid  tor  tape  files 
seek  called  with  an  invalid 
value  for  the  whence 

parameter _ 

attempt  to  seek  past  the  end 
of  the  specified  file  volume 
if  retval  =  FIO_OK,  the 
procedure  was  successful; 
if  retval  =  an  error  message, 
the  procedure  failed 
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Errors 

Error 

Reason  for  Error 

FIO_SEEK_PAST_BOF_ERROR 

Attempt  to  seek  past  the  beginning  of  the 
specified  file  vohjme 

FIO_SEEK_RELATIVE_TAPE_END_ERROR 

The  fio_seek_end  whence  value  is  invalid  for 
tape  files 

FIO  SEEK  INVALID  WHENCE  VALUE 
ERROR 

Seek  called  with  an  invalid  value  for  the 
whence  parameter 

FIO  SEEK  VOLUME  NOT  AVAILABLE 
ERROR 

Cannot  seek  to  the  specified  exerdse  time. 
Volume  is  not  available 

FIO  INTERNAL  ERROR 


FIO  DRIVE  NOT  READY  ERROR 


FIO  SEEK  PAST  EOF  ERROR 


ase 

at  tgtvol 

I  and  tgtvol>curvol 
s  tgt  volume 


Tape  drive  for  continuous  concatenated  tape 
files  is  not  readv 


Attempt  to  seek  past  the  end  of  the  specified 
file  volume 


Function 


TAPEINFO  PTRR 


VOLUME  STARTTIME 


WAIT  FOR  AST 


tvolume  starttime 


fio  error 


IS  CONTINUOUS 


tvolume  available 


VOLUME  NUMBER 


enqueue  tb 


OUEUE  COUNT 


dequeue  tb 


FIO  RECORD  OF  TBUFFER 


FIO  PACKET  TIME 


FIO  RECORD  PACKETS 


VOLUME  UFD 


XYLOGICS  472  DRIVE  READY 


eotv  phase  action 


XYLOGICS  472  DRIVE  ONLINE 


backuD  bast  tarqet 


read  fiofile  header 


read  stream 


WAIT  FOR  AST 


read  tbuffer 


FIO  RECORD  BYTE  COUNT 


FIO  RECORD  STARTTIME 


OUEUE  HEAD 


FIO  PACKET  SIZE 


Calls 


Where  Described 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1.4.2.14.33 


Sec.  2.1.4.2.4.1 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.1.4.2.14.32 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1.4.2.14.8 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1.4.2.14.9 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.1. 4.2.1  fiofile.h  (macro  definition 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1.4.2.14.3 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1.4.2.14.34 


Sec.  2.1.4.2.14.19 


Sec.  2.1.4.2.14.21 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1.4.2.14.20 


Sec.  2.1. 4.2.1  fiofile.h  (macro  definition 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 
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Called  B 


Function 

Where  Described 

fio  seek 

Sec.  2.1.4.2.2.9 

Table  2.1>106:  tape_seek  Information. 
2.1.4.2.14.31  tape_seek_time 

This  routine  returns  the  time  of  the  current  packet 


Parameters 


fio  file 


Parameter 


Where  Tvoedef  Declared 


Sec.  2.1. 4.2.1  fiofile.h 


Variable 


Internal  Variables 


e 


t 


IPT] 


Where  Tvpedef  Declared 


Sec.  2.1.4.2.14  fiotaoe.c 


Return  Value 


FIO_PACKET_TIME 
(tDtr->current  packet) 


lElT^ 


Return  Values 


Meanin 


the  time  of  the  current  packet 


rocedure  failed 


Function 


TAPEINFO  PTR 


FIO  PACKET  TIME 


Calls 


Where  Described 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Called  B 


Function 

Where  Described 

fio  seek 

Sec.  2.1.4.2.2.9 

Table  2.1-107:  tape_seek_time  Information. 

2.1.4.2.14.32  tvolume_available 

This  routine  returns  TRUE  when  the  desired  volume  is  mounted.  Note  that  this  procedure 
should  only  be  called  for  CONTINUOUS  files. 
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Internal  Variables 


Variable 


fhdr 


status 


ufd 


volnum 


base 


retval 


fio  header 


irssnsEiS! 


struct  mtaet 


mt 


int 


eotv  Dhs  e 


BOOL 


Where  Tvoedef  Declared 


Sec.  2. 1.4.1. 3  fioheader.h 


Sec.  2.1.4.2.14  fiotape.c 


Standard 


Standard 


Standard 


Sec.  2.1.4.2.14  fiotaoe.c 


Standard 


Return  Values 


Return  Value 


retval 


Meanin 


retval  =  TRUE  if  the  volume 
specified  in  vo/is  mounted; 
retval  >  FALSE  if  the  volume  is 
not  mounted 


Error 


FIO  INTERNAL  ERROR 


Errors 


Reason  for  Error 


Read  of  fio  header  failed 


Function 


TAPEINFO  PTR 


VOLUME  UFD 


XYLOGICS  472  DRIVE  READY 


fioerror 


et  version  chksum  fiohdr 


et  tape  number  fiohdr 


VOLUME  NUMBER 


eotv  phase  action 


XYLOGICS  472  DRIVE  ONLINE 


Calls 


Where  Described 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1.4.2.4.1 


Sec.  2.1.4.2.3.21 


Sec.  2.1.4.2.3.17 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Sec.  2.1.4.2.14.3 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Function 


tape  seek 


Called  B 


Where  Described 


Sec.  2.1.4.2.14.30 


Table  2.1-108:  tvolume  available  Information. 


2.1.4.2.14.33  tvolume_starttime 

This  routine  sets  a  pointer  to  the  starttime  of  the  volume  specified  in  voL 
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Internal  Variables 


Variable 


fhdr 


frcd 


ufd 


volnum 


retval 


hase 


status 


fio  header 


fio  record 


inter  to  ta 


int 


int 


int 


eotv  Ohs  e 


struct  mtoet 


Where  Tvpedef  Declared 


Sec.  2.1 .4.2.1  fiofile.h 


Sec.  2.1 .4.2.1  fiofile.h 


Sec.  2.1.4.2.14  fiotaoe.c 


Standard 


Standard 


Standard 


Sec.  2.1 .4.2.14  fiotaoe.c 


Standard 


Return  Values 


Return  Value 


FIO_SEEK_VOLUME_NOT 
AVAILABLE  ERROR 


retval 


Meanin 


The  procedure  failed 


If  retval  =  FIO_OK,  the 
procedure  was  successful; 
If  retval  =  an  error  message, 
the  procedure  failed 


Errors 

Error 

Reason  for  Error 

FIOJNTERNAL_ERROR 

-  Read  of  fhdr  failed 

-  Read  of  fired  failed 

FIO  SEEK  VOLUME  NOT  AVAILABLE 
ERROR 

Cannot  seek  to  the  specified  exercise  time; 
volume  is  not  available 

FIO_DRIVE_NOT_READY 

Tape  drive  for  continuous  concatenated  file  is 
not  readv 

Function 


TAPEINFO  PTR 


VOLUME  UFD 


XYLOGICS  472  DRIVE  READY 


fio  error 


et  version  chksum  error 


et  tape  number  fiohdr 


eotv  phase  action 


Calls 


Where  Described 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1 .4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1.4.2.14  fiotaoe.c  (macro  definition 


Sec.  2.1.4.2.4.1 


Sec.  2.1.4.2.3.21 


Sec.  2.1.4.2J.17 


Sec.  2.1.4.2.14.1 


Called  B 


Function 

Where  Described 

tape  seek 

Sec.  2.1.4.2.14.30 

Table  2.1>109:  tvoIume_starttime  Information. 
2.1.4.2.14.34  backup_past_target 

This  backs  up  the  specified  drive  past  the  specified  time,  sets  the  fio_file  pointer  and 
returns  the  total  number  of  records  backed  up. 
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Parameters 


Parameter 


ufd 


starttime 


■me 


lasttime 


trcds  to  start 


Where  Tvoedef  Declared 


Standard 


Standard 


Standard 


Standard 


Standard 


Variable 


ms  to  start 


ms  to  tot 


trcds  backed  u 


frcd 


Internal  Variables 


e 


inter  to  fio  record 


Return  Values 


Where  Tvoedef  Declared 


Standard 


Standard 


Standard 


Sec.  2.1. 4.2.1  fiofile.h 


Return  Value 


trcds_backed_up 


Meanin 


The  total  number  of 
fio  records  backed  u 


Error 


FIO  INTERNAL  ERROR 


Errors 


Reason  for  Error 


Backupjo  target:  negative  backup 
Backup_past_target:  large  MTBSR  failed 
Backup_past_target:  small  MTBSR  failed 
Backup  to  taroet  read  failed 


Function 


fio  error 


Unix  tape  action 


FIO  RECORD  STARTTIME 


Calls 


Where  Described 


Sec.  2.1.4.2.4.1 


Sec.  2.1.4.2.14.4 


Sec.  2.1.4.2.14  fiotape.c  (macro  definition 


Called  B 


Function 

Where  Described 

tape  seek 

Sec.  2.1.4.2.14.30 

Table  2.1>110:  backup_past_target  Information. 
2.1.4.2.14.35  tape_getrawfd 

This  routine  returns  the  raw  Unix  file  descriptor  for  the  volume  specified  in  volume  offset. 


Parameters 


Parameter 


volume  offset 


e 


fio  file 


int 


Where  Tvoedef  Declared 


Sec.  2.1. 4.2.1  fiofile.h 


Standard 
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Table  2.1*11 1:  tape_getrawfd  Information. 

2.1.4.2.14.36  tape_close 

This  routine  closes  an  open  tape  file.  The  state  of  the  file  is  checked.  If  the  file  is  opened 
for  writing,  all  lOCTL  calls  must  have  been  executed.  The  remaining  filled_tbq  tbuffers, 
the  remaining  private_tbq  tbuffers,  and  the  current_tbuffer  are  freed  and  memory 
allocations  are  cleaned  up.  This  routine  is  called  from  the  "fiolib.c"  routine  fio_close(). 


Parameters 


Parameter 


ufd 


Where  Typedef  Declared 


Standard 


Variable 


tbuf 


frcd 


write  reds 


ufd 


Internal  Variables 


e 


inter  to  register  taoe  t 


inter  to  tbuffer  t 


inter  to  fio  record 


BOOL 


int 


int 


int 


int 


Where  Typedef  Declared 


Sec.  2.1.4.2.14  fiotaoe.c 


Sec.  2.1.4.2.14  fiotape.c 


Sec.  2.1. 4.2.1  fictile. h 


Standard 


Standard 


Standard 


Standard 


Standard 


Return  Value 


retval 


Return  Values 


Meanin 


If  retval  =  FIO_OK,  the 
procedure  was  successful; 
If  retval »  an  error  message, 
the  procedure  failed 
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1  Errors  1 

Error 

Reason  for  Error 

FIO  CLOSE  UNIX  ERROR 

Error  closinq  file 

FIO  INTERNAL  ERROR 

Tape  close:  filled  tbq  is  not  empty 

Calls 

Function 

Where  Described 

TAPEINFO  PTR 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

DISABLE  AST 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

IS  WRITABLE 

Sec.  2.1. 4.1.1  fiolib.h  (macro  definition) 

FIO  RECORD  OF  TBUFFER 

Sec.  2.1.4.2.14  fiotape.c  (macro  defirvtion) 

FIO  RECORD  PACKETS 

Sec.  2.1.4.2.1  fiofile.h  (macro  definition) 

FIO  RECORD  BYTE  COUNT 

Sec.  2.1. 4.2.1  fiofile.h  (macro  definition) 

write  tbuffer 

Sec.  2.1.4.2.14.26 

enqueue  tb 

Sec.  2.1.4.2.14.8 

QUEUE  COUNT 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

write  stream 

Sec.  2.1.4.2.14.27 

WAIT  FOR  AST 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

RESTORE  AST 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

VOLUME  UFD 

Sec.  2.1.4.2.14  fiotape.c  (macro  definition) 

dequeue  tb 

Sec.  2.1.4.2.14.9 

fio  free 

Sec.  2.1.4.2.5.2 

Called  Bv 

Function 

Where  Described 

tape  open 

Sec.  2.1.4.2.14.16 

fio  close 

Sec.  2.1.4.2.2.12 

Table  2.1>112:  tape_close  Information. 


105 


BBN  Systems  and  Technologies 


Data  Logger  CSQ 


2.2  Data  Logger  Files 


Figure  2-2:  Data  Logger  Files  Software  Structure 


2.2.1  Data  Logger  Header  Files 

2.2. 1.1  cmc.h 

cmc.h  defines  some  cmc  network  specific  routines. 

DeHnes: 

CMC.PATH 

ACCEPT.ALL 

REG_SHFT 

REG_MASK 

BPB 

NUM_EXERCISE_IDS 

NUM_EXERCISE_REGISTERS 

ACCEPT.EXERCISE 

NUM_PROTOCOL_REGISTERS 
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NUM_PROTOCOL_IDS 
ACCEPT.PROTOCOL 
proprietary  ProtocolNumbers 

Accounting  Macros: 

INC_SENDPVD_COUNT() 

INC_RCVDPVD_COUNT() 

INC_SEND_COUNT() 

INC  RCVD.COUNTQ 
INC_LATE_COUNT0 
INC_LATE_MARGIN() 

INC_DROP_COUNT() 

INC_FILTER_COUNT() 

Global  Variable  Declarations: 
sendpvd_count 
tcvdpvd_count 
send_count 
rcvd_count 
late_count 
late_margin 
drop_count 
filter_count 

External  procedure  declarations: 
cinc_init() 
cinc“term() 
cinc”accept() 
cnic”protocoI_types() 
cinc“zero_starus() 
cmc”report_status() 
cmc'gettiinel6() 
cmc~gettime320 
cinc_settime() 

2.2. 1.2  logger. h 

This  file  defines  the  interface  to  the  logger  finite  state  machine.  This  file  exports  a  number 

of  global  variables  which  act  as  flags  for  the  finite  state  machine. 

Includes  "p_logger.h" 

External  procedure  declarations: 
logger_op_error() 

Iogger~connect() 

logger~disconnect() 

logger”seek_reIative() 

logger~speed() 

logger'stopO 

logger_start() 

logger~suspend() 

logger_statu.s() 

logger”get_sta  t  e() 

Iogger”get~activity() 
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2.2. 1.3  queue.h 

"queue.h"  is  a  low  level  module  which  provides  a  general  purpose  queueing  facility. 

Defines: 

FREE_QUEUE 

IN_QUEUE 

OUT_QUEUE 

External  procedure  definitions: 
init  queuesO 
rein!t_queues() 
enqueueQ 
dequeueQ 
queue_count() 

2.2. 1.4  racal.h 

The  racal.h  file  defines  the  following: 

CMC_MILL1_THRESH 

WAIT_INIT_CHAR 

GET_N_CHARS 

GET_TERM_CHAR_1 

GET_TERM_CHAR_2 

External  procedure  declarations: 
racal_close() 
racaljopenO 
reset  jracal_time() 
racarstart”recording() 
racal_start~playing() 
racaPstopd 
racal~seek_to_time() 

2.2. 1.5  rtc.h 

This  file  handles  the  Run-Time  Commands.  When  the  logger  is  in  interactive  mode,  run¬ 
time  commands  will  be  coming  from  STDIN.  When  the  logger  is  in  Server  naode,  mn-time 

commands  will  be  coming  from  the  client  over  the  CMC  network. 

Includes: 

”p_assoc.h" 

"pjogger.h" 

"network.h" 

"fiolib.h" 

External  Procedure  Declarations: 
init_rtc() 
free_rtc() 

logg'er  message  location() 

logger_msg() 

logger  ~error() 

protoc'bl_of() 

rtc_size(y 
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handle_rtc() 

handle”reinote_rtc() 

new_rtc() 

send[_clock_tick() 

2.2. 1.6  timer.h 

This  file  declares  the  external  interface  to  "timer.c". 
on__time() 

serfast_time_factor() 

get”fasrtiine_factor() 

set__timel) 

gertimeO 

freeze_time() 

unfre^e  timeO 

time_string() 

2. 2. 1.7  user.h 

This  file  declares  the  interface  to  the  User  Interface  file,  "user.c". 

External  procedure  declarations: 

collect_racaI_tiine_info() 

collect~fiofile  lnfo() 

collect~cmcsuBscribe_info() 

coUect~fioheader  info() 

collect~playbackJlnfo() 

continue_or_quitO 

yes_or_nb(r 

2.2. 1.8  util.h 


Defines: 

MAX.VOLUMES 

DISK_FILE 

NET_FILE 

TAPE.FILE 

Typedefs: 

FIOLE_INFO  file_info 

External  Procedure  Declaration: 
inlt_file_info() 

2.2. 1.9  global.h 

This  file  defines  some  global  macros: 
MIN 
MAX 
ABS 
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2.2.1.10  logfilt.h 

This  file  defines  logger  filterO,  an  external  procedure  used  by  the  CMC  logger  filter 
routine  and  the  exercise ^tering  mechanism  of  the  logger. 


2.2.2  Data  Logger  Files 
2. 2. 2.1  cmc.c 

This  file  provides  an  interface  to  services  provided  by  the  SIMNET  netwOTk  interface 
library  (libnedf).  The  services  used  include  the  timer,  statistics  about  the  number  of 
packets  handled  and  the  downloadable  filter,  a  mechanism  for  filtering  out  PDU's. 

Includes: 

<stdio.h> 

<fcntl.h> 

<sys/types.h> 

"sim_defines.h" 

"network.h" 

"netfilter.h" 

"nettab.h" 

"enpiocd.h" 

"global.h" 

"rtc.h" 

"cmc.h" 


Standard  Procedure  Declarations: 

free() 

mallocO 

perrorO 

timeO 


External  Procedure  Declaration: 
cmc_rilter_init() 


Exported  Global  Variables: 
sendpvd_count 
rcvdpvd_count 

send_count 

rcvd_count 

late_count 

late_margin 

drop_count 

filter_count 

cmc_base_time 

cmcfd 

msgbuf[256] 


-the  number  of  RTC  packets  sent  on  the  logger's  client 
"the  number  of  RTC  packets  received  from  the  logger's 
client 

"the  number  of  packets  sent  on  the  CMC  network 

"the  number  of  packets  received  from  the  CMC  networic 

"the  number  of  packets  sent  late 

"the  margin  by  which  packets  are  sent  late 

"the  number  of  packets  dropped 

"the  number  of  packets  filtei^ 

-used  in  conjunction  with  the  16- bit  clock,  the  base  time 
from  which  the  16-bit  network  clock  is  an  offset, 
"the  UNIX  file  descriptor  for  dealing  with  CMC  networic. 
"the  buffer  for  messages. 


The  next  few  routines,  (2.2.2. 1.1  through  2.2.2. 1.4)  constitute  the  interface  to  the 
downloadable  filter.  TTiis  filter  (see  logfilt.c)  is  loaded  onto  the  ethemet  card  by  a  separate 
program  (netstart).  These  routines  provide  a  mechanism  for  the  logger  to  communicate 
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with  the  filter  during  runtime.  The  filter  is  used  to  weed  out  unwanted  packets  at  the  board 
level  when  the  logger  is  recording.  The  filter  is  written  to  filter  out  packets  based  on 
ExerciselD  and  on  Protocol. 


Defines: 

ACCEPT_ALL_IDS 

CMC.FILTER 

2. 2. 2. 1.1  cinc_filter_init 

This  routine  initializes  the  filter  on  the  CMC  card.  The  filter  is  initialized  to  accept  only 
logger  RTC  packets. 


This  routine  initializes  the  list  of  protocol  types  which  the  logger  will  accept.  Currently  the 
logger  will  accept  only  simulation  type,  or  voice  type,  or  both. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

standard 

Calls 

Function 

Where  Described 

net  flush 

Sec.  2.20.1  See  MCC  CSCI  SDD 

net  reg  write 

Sec.  2.20.1  See  MCC  CSCI  SDD 

cmc  accept 

Sec.  2.2.2.1.3 

Called  Bv 

Function 

Where  Described 

cmc  init 

Sec.  2.2  2.1. 5 

Table  2.2-1;  cmc_filter_lnit  Information. 
2.2.2. 1.2  cmc  protocol  types 


Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Sim  protocol 

BOOL 

standard 

voice  protocol 

BOOL 

Standard 

!  Calls  1 

Function 

Where  Described 

net  init  type 

Sec.  2.20.1  See  MCC  CSCI  SDD 

net  add  type 

Sec.  2.20.1  See  MCC  CSCI  SDD 

Called  By  1 

Function 

Where  Described 

Sec.  2.2.2.2.29 

Table  2.2-2:  cmc_protocol_types  Information. 
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2.2.2. 1.3  cmc_accept 

This  routine  adds  an  exercise^rotocol  ID  to  the  list  to  be  accepted  by  the  logger’s  CMC 
filter.  Passing  a  value  of  ACCTPT_ALL  is  an  indication  that  all  exeicise^rotocol  ID's 
should  be  accepted.  This  routine  returns  a  1  on  successful  completion  and  0  if  the 
operation  fails. 


Parameter 


Id 


IS  exercise 


Parameters 


Where  Typedef  Declared 


standard 


standard 


Variable 


reo  index 


last  id 


num  re 


rea  value 


IEI73 


internal  Variables 


e 


reaister  int 


int 


int 


int 


int 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


standard 


Return  Values 


Return  Value 


Meanin 


The  orocedure  failed 


The  procedure  was  successful 


Error 


lOQoer  error 


Errors 


Reason  for  Error 


Invalid  ID  value 


Function 


loQoer  error 


net  req  write 


net  req  read 


Calls 


Where  Described 


Sec.  2.2.2.5  3 


Sec.  2.20.1  See  MCC  CSCI SDD 


Sec.  2.20.1  See  MCC  CSCI  SDD 


Function 


cmc  filter  init 


loqqer  accept  pdus 


Called  B 


Where  Described 


Sec.  2.2.2. 1.1 


Sec.  2.2.2.2.12 


Table  2.2-3:  cmc_accept  Information. 
2.2.2. 1.4  cmc_reject 


This  routine  removes  an  exercise/protocol  ID  from  the  list  to  be  accepted  by  the  logger's 
CMC  filter.  This  routine  returns  1  on  successful  completion  and  0  if  the  operation  fails. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

id 

int 

standard 

is  exercise 

int 

standard 
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Internal  Variables 


Variable 


reo  index 


last  Id 


rea  value 


reaister  int 


int 


mt 


Where  Tyoedef  Declared 


standard 


standard 


standard 


Return  Values 


Return  Value 


Meanin 


The  orocedure  failed 


The  procedure  was  successful 


Error 


looaer  error 


Errors 


Reason  for  Error 


Invalid  ID  value 


Function 


loader  error 


net  rea  write 


net  rea  read 


Calls 


Where  Described 


Sec.  2.2.2.5.3 


Sec.  2.20.1  See  MCC  CSCI SDD 


Sec.  2.20.1  See  MCC  CSCI  SDD 


Called  B 


Function 

Where  Described 

loader  accept  pdus 

Sec.  2.2.2.2.12 

Table  2.2-4:  cmc_reject  Information. 

2.2.2. 1.5  cmcjnit 

This  routine  initializes  the  CMC  network  in  the  appropriate  naodes: 
sendpvd_count  =  0 
rcvpvd_count  =  0 
send_count  =  0 
rcvd_count  =  0 
late_count  =  0 
drop_count  =  0 
filter_count  =  0 
cmc_base_time  =  0 
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1  Calls  1 

Function 

Where  Described 

cmc  filter  init 

Sec.  2.2.2. 1.1 

longer  init  cmc 

Sec.  2.2.2.2.11 

Table  2.2>5:  cinc_init  Information. 

2.2.2. 1.6  cmc_term 

This  routine  terminates  the  CMC  networic  in  the  appropriate  modes.  The  routine  returns  1 
on  successful  completicxi  and  0  if  the  operation  fads. 


1  Return  Values  1 

Return  Value 

Tvoe 

Meaning 

0 

int 

The  procedure  failed 

1 

int 

The  procedure  was  successful 

Table  2.2*6:  cmc_term  Information. 

2.2.2. 1.7  cmc_zero_status 

This  routine  zeroes  the  statistics  about  the  network  which  are  being  kept  by  the  network 
library  (libnetif).  The  routine  returns  1  on  successful  completion  and  0  if  the  operation 
fails. 


1  Calls  1 

Function 

Where  Described 

net  zero  statistics 

Sec.  2.20.1  See  MCC  CSCI  SDD 

1  Called  Bv  1 

Function 

Where  Described  1 

logger  continue 

Table  2.2-7:  cmc_zero_status  Information. 

2.2.2. 1.8  cmc_report_status 

This  routine  reports  the  statistics  about  the  network  which  the  network  library  has  been 
keeping. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

recording 

BOOL 

standard 

play  time 

int 

standard 

Internal  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

status  bufferfN  STATSl 

int 

standard 

seconds 

float 

standard 

status  stringfSOI 

char 

standard 

stat 

int 

standard 
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1  Calls  1 

Function 

Where  Described 

net  aet  characteristics 

Sec.  2.20.1  See  MCC  CSCI SDD 

loaaer  msa 

Sec.  2.2.2.5.2 

net  stat  string 

Sec.  2.20.1  See  MCC  CSCI  SDD 

Called  Bv 

Function 

Where  Described 

ccatcher 

Sec.  2.2.2.2.34 

logger  stop 

Sec.  2.2.2.2.28 

Table  2.2-8:  cmc_report_status  Information. 

The  next  few  routines  (2.2.2. 1.9  through  2.2.2.1.11)  are  low  level  routines  for  getting  and 
setting  the  clocks  on  the  ethemet  card. 


2.2.2. 1.9  cmc_gettimel6 

This  routine  gets  the  value  of  the  16  bit  timer  from  the  CMC  card. 
One  count  =  998.26  microseconds. 


Return 

Values 

Return  Value 

Meaning 

net_current  time(cmfd)  + 

int 

The  value  of  the  16  bit  timer 

cmc  base  time 

from  the  CMC  card 

1  Calls  1 

Function 

Where  Described 

net  current  time 

Sec.  2.20.1  See  MCC  CSCI  SDD 

1  Called  Bv  1 

Function 

Where  Described 

on  time 

Sec.  2.2.2.6.10 

Table  2.2-9:  cmc_gettimel6  Information. 
2.2.2.1.10  cmc_gettime32 

This  routine  gets  the  value  of  the  32  bit  timer  from  the  CMC  card. 

One  count  =  998.26  microseconds. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

net_5ettime(cmfd) 

int 

The  value  of  the  32  bit  timer 
from  the  CMC  card 

Calls 

Function 

Where  Described 

net  gettime 

Sec.  2.20.1  See  MCC  CSCI  SDD 
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1  Called  By  I 

Function 

Where  Described 

aet  time 

Sec.  2.2  2.6.7 

unfreeze  time 

Sec.  2.2.2.6.9 

freeze  time 

Sec.  2.2.2  6.8 

Table  2.2>10:  cmc_gettime32  Information. 

2.2.2.1.11  cmc_settime 

This  routine  sets  the  values  of  both  the  16-bit  and  32-bit  timers  frcmi  the  CMC  card. 
One  count  =  998.26  microseconds.  The  parameter  ntime  is  the  new  value  fcB-  the  32-bit 
timer  on  the  CMC  card. 


i  Parameters  1 

Parameter 

Where  Typedef  Declared 

ntime 

int 

standard 

1  Calls  1 

Function 

Where  Described 

net  init  time 

Sec.  2.20.1  See  MCC  CSCI SDD 

net  settime 

Sec.  2.20.1  See  MCC  CSCI  SDD 

1  Called  By  1 

Function 

Where  Described 

reset  time 

Sec.  2.2.2.6.5 

set  time 

Sec.  2.2.2.6.6 

set  fast  time  factor 

Sec.  2.2.2.6.3 

Table  2.2-11:  cmc_settime  Information. 

2. 2. 2. 2  logger.c 

This  is  the  primary  file  for  the  Data  Logger.  The  basic  structure  of  the  Data  Logger 
involves  an  initialization  phase  during  which  the  Data  Logger  is  placed  in  either  stand-alone 
or  server  mode  and  then  initialized  for  recording,  playback,  or  copying.  The  Data  Logger 
then  enters  the  main  loop  of  the  program.  In  the  main  loop,  the  Data  Logger  takes  care  of 
two  primary  functions;  (1)  to  aquire  and  process  packets,  and  (2)  to  respond  to  run-time 
commands. 

Includes: 

<signal.h> 

>stdio.h> 

<sysAioctl.h> 

<sys/types.h> 

<sys/timeb.h> 

<sy  s/times.  h> 

<time.h> 
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Tiolib.h" 

"fioheader.h" 

"fioerror.h" 

"network.h" 

"p_nuni.h" 

"pjogger.h" 

"global.h" 

"cmc.h" 

"logger.h" 

"logtime.h" 

"queue.h" 

"racal.h" 

"rtc.h" 

"timer.h" 

"user.h" 

"utiLh" 

Standard  Procedures: 

perrorO 

exitO 

strcatO 

strncpyO 

Static  Procedures: 

process_parins() 

inU_stare_variabIes() 

init3ogg^_variabIes() 

loggerJnitO 

iiiit_logger_for_server() 

itiiMogger^for'copyingO 

iniMogger'for^laybackO 

iniMogger  for”recording() 

open_fio_fries 

Iogger_accept_pdus() 

logger_init_cinc() 

Iogger~get_remote_rtc() 

logger~purremote~rtc() 

Iogger_fsin()  ~ 

logger~copying_state() 

logger~playback_state() 

logger_recording]_stateO 

logger”reset() 

logger~clock_tick() 

print_adviceO 

ccatcherO 

belisO 

print_command_line_help() 

Defines: 

Alarm  Level: 

NOTE 

ALARM 

PANIC 
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DataProbe  Header 
TAPE.TYPE 
RUN.NUM 
START_TAPE_NUM 
BPW 

HDR.SIZE 

DATE_OF_COPY 

CYCLES_PER_RTC_MASK 

LATE_MARGIN 

DRIVE_NOT_READY_CRISIS_BOUND 

MAX_FAILED_READS 

MAX_DNR_ERRORS 

CLOCKTICK.INTERVAL 


Declarations: 

Logger  State  Variables: 
logger_state 
logger_activity 
logger_operation 
logger_activity_started 

Static  Variables: 
controLc 
debug 
maxprio 
query_all 
lacal 

Global  File  Variables: 
rd_flles 
wr_files 
fio_hdr 
readfd 
writefd 
cmcfd 

Fio_header  String  Defines  and  Variables: 

FILEID_SZ 

filejd 

conimand_str 

dp_coniinent 

dp_project 

start_date_str 

start_time_str 

Time  on  Racal  clock  (translated  to  CMC  msec)  when  CMC  clock  reads  0  Variables: 
racal_time_at_start 
start_datetime 
current_timestamp 
copied_count 
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msgbuf 

saved_packet 

write_packet 

Filtering  on  Playback  Macros  and  Variables: 

playback_stealth_protocol 

InitPlaybackFilterO 

FilterPiotocolO 

2. 2. 2. 2.1  main 

mainO  is  the  entry  point  of  the  Data  Logger  program. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

aroc 

int 

standard 

argyn 

pointer  to  char 

standard 

1  Return  Values  1 

Return  Value 

Meanina 

0 

int 

The  operation  was  successful 

1  Calls  1 

Function 

Where  Described 

init  state  variables 

Sec.  2.2  2.2.3 

init  queues 

Sec.  2.2.2.3.4 

init  rtc 

Sec.  2.2.2.5.6 

init  user 

Sec.  2.2.2.7.13 

lOQQer  messaae  location 

Sec.  2.2.2.5.1 

process  parms 

Sec.  2.2  2.2.2 

lOQQer  msq 

Sec.  2.2.2.5.2 

ves  or  no 

Sec.  2.2.2.7.9 

init  loqqer  variables 

Sec.  2.2.2.2.4 

loqqer  init 

Sec.  2.2  2.2.5 

loqqer  fsm 

Sec.  2.2.2.2.15 

loqqer  reset 

Sec.  2.2.2.2.20 

Table  2.2>12:  main  Information. 
2. 2. 2. 2. 2  process_parms 

This  routine  processes  the  command-line  flags. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

aroc 

int 

standard 

amv[] 

pointer  to  char 

standard 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

proqname 

pointer  to  char 

standard 

i 

int 

standard 
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1  Errors  1 

Error 

Reason  for  Error 

logger_error 

*  Specifying  activity  not  allowed  in 

LoggerServer  mode 

•  Cannot  copy  and  record  simultaneously 

-  Cannot  copy  and  play  sinHiltaneously 

-  Cannot  play  and  record  simultaneously 

-  Cannot  play  and  copy  simultaneously 

-  Cannot  record  and  play  simultaneously 

-  Cannot  record  and  copy  simultaneously 

-  Unknown  switch 

-  Loqqer  must  copy,  play,  or  record 

Calls 

Function 

Where  Described 

looaer  msa 

Sec.  2.2.2  5.2 

print  command  line  help 

Sec.  2.2.2.2.36 

loqqer  error 

Sec.  2.2  2.5.3 

Called  Bv 

Function 

Where  Described 

main 

Sec.  2.2.2.2.1 

Table  2.2-13:  process_parms  Information. 
2. 2. 2. 2. 3  init  state  variables 


This  routine  initializes  the  state  variables  as  follows; 


logger_activity: 

logger_operation: 

logger_state: 

logger_activity_started: 

controLc: 

debug: 

maxprio: 

query_all: 

racal: 


loggerNoActivity 

loggerinteractive 

LoggerDisconnected 


FALSE 

FALSE 

FALSE 

FALSE 

FALSE 

FALSE 


1  Called  Bv  1 

Function 

Where  Described 

main 

Sec.  2.2.2.2.1 

Table  2.2-14:  init_state_variables. 
2. 2. 2. 2. 4  init_logger_variables 

This  routine  initializes  the  logger  variables. 


1  Calls  I 

Function 

Where  Described 

init  file  info 

Sec.  2.2.2.8.1 

null  fiohdr 

Sec.  2.1.4.2.3.23 
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1  Called  By  1 

Function 

Where  Described 

main 

Sec.  2.2.2.2.1 

Table  2.2>15:  init_iogger_variables  Information. 
2.2.2.2.S  logger_init 

This  routine  calls  different  initialization  routines  depending  on  the  logger  activity: 
recording,  playback,  or  copying. 


1  Calls  1 

Function 

Where  Described 

reinit  queues 

Sec.  2.2.2.3.5 

init  loqqer  for  server 

Sec.  2.2.2.2.6 

init  loaaer  for  copyinq 

Sec.  2.2.2.2.7 

init  loqqer  for  playback 

Sec.  2.2.2.2.8 

init  loqqer  for  recordinq 

Sec.  2.2.2.2.9 

Called  By 

Function 

Where  Described 

main 

Sec.  2.2.2.2.1 

Table  2.2-16:  logger^init  Information. 
2. 2. 2. 2. 6  init_Iogger_for_server 

This  routine  initializes  the  logger  for  server  mode. 


1  Calls  1 

Function 

Where  Described 

loqqer  init  cmc 

Sec.  2.2.2.2.11 

loqqer  messaqe  location 

Sec.  2.2.2.5.1 

loqqer  qet  remote  rtc 

Sec.  2.2.2.2.13 

handle  remote  rtc 

Sec.  2.2.2.5.13 

loqqer  put  remote  rtc 

Sec.  2.2.2.2.14 

Called  By 

Function 

Where  Described 

loqqer  init 

Sec.  2.2.2.2  5 

Table  2.2-17;  init_logger_for_server  Information. 
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1.1. 1.1.1  init_Iogger_for_copying 

This  routine  initializes  the  logger  fca*  copying.  It  collects  infcHtnatitMi  about  files  to  be 
copied  and  opens  them. 


Internal  Variables 


Variable 


start  dt 


start_dstr 

DATE  OF  RUN  SZ  +1 


start_tstr 

IME  OF  RUN  SZ  +  T 


comment_str 
COMMENT  SZ  +  1 


project_str 
PROJECT  ID  SZ  +  1 


file  nm 


ex_ids 

eiMaxExerdselDs  + 1 


LoaaerTime 


char 


Where  Tvoedef  Declared 


er.dm  (Appendix  A 


standard 


inter  to  char 


char 


int 


int 


BOOL 


standard 


standard 


standard 


standard 


standard 


standard 


standard 


standard 


Errors 

Error 

Reason  for  Error 

FIO_VERSION1_ERROR 

Fio  file  volume  has  an  invalid  version  ID 
(Versioni) 

F(0_VERS(0N2_ERR0R 

Fio  file  volume  has  an  invalid  version  ID 
(Version2) 

loqqer  error 


File  was  soecified  for  both  readinq  and  wnti 


Jl!l 


Function 


es  or  no 


collect  fiofile  info 


open  fio  files 


fio  IS  null  header 


et  fileid  fiohdr 


loqqer  error 


et  datetime 


datetime  to  stnnqs 


fio  file  header 


fio  convert  header 


fio  print  fiohdr 


Calls 


Where 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Described 


2.2.7.9 


2.2.52 


2.2.7.2 


2.2.2.10 


1.4.2.3.1 


1.4.2.3.12 


2.2.53 


1. 3.2.6 


1. 3.2.5 


1 .4.2.3  .3 


1. 4.23.2 


1.4.2.3.22 


Called  B 


Function 

Where  Described 

loqqer  init 

Sec.  2.2.2.2  5 

Table  2.2-18:  iniMogger_for_copying  Information. 
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2 . 2 . 2 .2 .8  init_logger_for_playback 


This  routine  initializes  the  logger  for  playback.  Information  is  collected  about  the  SIMNET 
data  Rles  to  be  played  back.  The  network  is  initialized. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

play  stealth  protocol 

BOOL 

standard 

files 

file  info 

Sec.  2.2.1. 8  util.h 

1  Calls  1 

Function 

Where  Described 

looaer  init  cmc 

Sec.  2.2.2.2.11 

init  file  info 

Sec.  2.2.2.8.1 

loader  msa 

Sec.  2.2.2.5  2 

collect  fiofile  info 

Sec.  2.2.2.7.2 

collect  playback  info 

Sec.  2.2.2.7.7 

yes  or  no 

Sec.  2.2.2.7.9 

II '  1 1  li  11  li— — 

Sec.  2.2.2.2.29 

1  Called  Bv  1 

Function 

Where  Described 

loaaer  init 

Sec.  2.2.2.2  5 

Table  2.2-19:  initJogger_for_playback  Information. 
2 .2 .2 . 2 . 9  init_logger_for_recordlng 


This  routine  initializes  the  logger  for  recording.  The  routine  collects  information  about  the 
CMC  Network  initialization,  the  start  time  of  the  exercise,  and  the  SIMNET  file  and  file 
header. 


Variable 


sim  orolocol 


voice  orotocol 


num  exercises 


exercises 

lOQQerMaxExercisel  Ds+T 


std  protocols 


nstd  protocols 


start  dt 


flies 


comment_str 
COMMENT  SZ  +  1 


project_str 

PROJECT  ID  SZ  +  11 


Internal  Variables 


e 


BOOL 


BOOL 


short 


char 


short 


short 


LooaerTime 


file  info 


char 


Where  Typedef  Declared 


standard 


standard 


standard 


standard 


standard 


standard 


Sec.  2.2.1. 8  util.h 


standard 


standard 
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Function 


loaaer  mit  cmc 


loaaer  ms 


collect  cmcsubscnbe  info 


et  datetime 


init  file  info 


collect  fiofile  info 


collect  fioheader  info 


es  or  no 


er  start 


Calls 


Where  Described 


Sec.  2.2.2.2.11 


Sec.  2.2.2.5  2 


Sec.  2.2.2.7.5 


Sec.  2.1. 3.2.6 


Sec.  2.2.2.8.1 


Sec.  2.2.2.7.2 


Sec.  2.2.2.7.6 


Sec.  2.2.2  7.9 


Sec.  2.2.2.2.29 


Called  B 


Function 

Where  Described 

init  loaaer 

Sec.  2.2.2  2.5 

Table  2.2-20:  init_logger_for_recording  Information. 
2.2.2.2.10  open_fio_files 

This  routine  opens  the  specified  files  for  the  Data  Logger. 
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Table  2.2*21:  open_flo_nies  Information. 
2.2.2.2.11  logger_init_cmc 
This  routine  opens  and  initializes  the  CMC  network. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

cmc  oflags 

int 

standard 

1  Errors  I 

Error 

Reason  for  Error 

logger_error 

-  Unable  to  initialize  CMC  netwoik 

-  Fa'Ied  to  initialize  the  CMC  filter 

1  Calls  1 

Function 

Where  Described 

fio  open 

Sec.  2.1.4.2.2.5 

loaaer  error 

Sec.  2.2  2.5.3 

fio  error 

Sec.  2.1. 4.2.4. 1 

cmc  init 

Sec.  2.2.2.1.5 

1  Called  By  1 

Function 

Where  Described 

init  loooer  for  server 

Sec.  2.2.2  2.6 

init  ioaoer  for  playback 

Sec.  2.2.2.2.8 

init  loqoer  for  recording 

Sec.  2.2  2.2.9 

Table  2.2*22:  logger jnit_cmc  Information. 
2.2.2.2.12  iogger_accept_pdus 


This  routine  sets  up  the  CMC  filter.  It  accepts  PDU’s  of  standard  protocol  (if  requested) 
and  non-standard  protocol  (if  requested).  Logger  run-time  commands  (RTC)  always 
accepted. 
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Parameters 


Parameter 


num  exercises 


exercises 


num  stdorotocols 


num  nstdorotocols 


Where  Tvpedef  Declared 


standard 


standard 


standard 


standard 


Variable 


Internal  Variables 


Where  Tvpedef  Declared 


standard 


Error 


logger_error 


Errors 


Reason  for  Error 


-  Failed  to  accept  exerdselD 

-  Failed  to  accept  protocols 

-  Failed  to  reiect  protocols 


Function 


cmc  accept 


looaer  error 


cmc  reiect 


Calls 


Where  Described 


Sec.  2.2.2. 1.S 


Sec.  2.2.2.5.3 


Sec.  2.2.2. 1.4 


Function 


loaaer  start 


Called  B 


Where  Described 


Sec.  2.2.2.2.29 


Table  2.2<23:  logger_accept_pdus  Information. 


2.2.2.2.13  logger_get_remote_rtc 

This  routine  reads  a  run  time  command  from  the  CMC  network  and  places  it  on  the  IN 
command  queue. 


Variable 


rtc 


kt 


Internal  Variables 


e 


inter  to  fiooacket 


inter  to  fio  packet 


Where  Tvpedef  Declared 


Sec.  2. 1.4. 1.1  fiolib.h 


Sec.  2. 1.4. 1.1  fiolib.h 


Error 


looaer  error 


Errors 


Reason  for  Error 


Unexpected  fio  read  error 


Function 


fio  read 


rotocol  of 


INC  RCVDPVD  COUNT 


now  rtc 


'  ^  PACKET  SIZE 


IN  QUEUE 


Calls 


Where  Described 


Sec.  2.1.4.2.2.7 


Sec.  2.2  2.5.4 


Sec.  2.2.1. 1  cmc.h  (macro  definition 


Sec.  2.2.2.5.14 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.2.1 .3  queue. h  (macro  definition 
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1  Called  Bv  1 

Function 

Where  Described 

lOQQer  fsm 

Sec.  2.2.2.2.15 

init  looaer  for  server 

Sec.  2  2.2.2.6 

Table  2.2-24:  logger_get_remote_rtc  Information. 

2.2.2.2.14  Iogger_put_remote_rtc 

This  routine  reads  a  run  time  command  from  the  OUT  command  queue  and  places  it  on  the 
CMC  Network. 


1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

pktbuf 

[MAX  FIO  PACKET  SIZE! 

char 

standard 

rtc  available 

BOOL 

standard 

pkt 

pointer  to  fio  packet 

Sec.  2. 1.4. 1.1  fiolib.h 

rtc 

pointer  to  fio  packet 

Sec.  2. 1.4. 1.1  fiolib.h 

1  Errors  1 

Error 

Reason  for  Error 

FIO  NET  WRITE  ERROR 

Unable  to  write  packet  to  network  device 

fio  error 

Unexpected  error  on  playback 

1  Calls  1 

Function 

Where  Described 

queue  count 

Sec.  2.2.2.3.8 

dequeue 

Sec.  2.2.2.3.7 

FIO  PACKET  SIZE 

Sec.  2.1. 4.1.1  fiolib.h  (macro  definition) 

free  rtc 

Sec.  2.2.2.5.15 

fio  write 

Sec.  2.1.4.2.2.8 

INC  RCVDPVD  COUNT 

Sec.  2.2. 1.1  cmc.h  (macro  definition) 

fio  error 

Sec.  2.1.4.2.4.1 

1  Called  Bv  1 

Function 

Where  Described 

loqqer  fsm 

Sec.  2.2.2.2.15 

Table  2.2-25:  logger_put_remote_rtc  Information. 

2.2.2.2.15  logger_fsm 

This  routine  is  the  Finite  State  Machine.  The  logger  spends  most  of  its  time  here  in  an 
internal  loop.  In  each  cycle  the  logger  acquires  a  packet  and  processes  it.  For  example, 
during  playback,  the  logger  reads  a  packet  from  the  logger  file  and  writes  it  to  the  network. 
Every  so  many  cycles,  the  logger  checks  for  a  run-time  command  and  processes  it  if  one  is 
found. 
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Internal  variables 


Variable 


cycles 


unsianed 


Where  Typedef  Declared 


standard 


Error 


logger_error 


Errors 


Reason  for  Error 


•  F^led  to  set  to  real-time  pnority 

-  Running  at  real-time  priority 

-  Unknown  activity 

-  Unknown  state 

-  Fated  to  reset  to  real-time  priority 

-  Runninq  at  normal  priority 


Function 


lOQoer  copyino  state 


er  playback  state 


looqer  record  state 


loqqer  qet  remote  rtc 


handle  rtc 


loqqer  put  remote  rtc 


loqqer  clock  tick 


loqqer  error 


Calls 


Where  Described 


Sec.  2.2.2.2.16 


Sec.  2.2.2.2.17 


Sec.  2.2.2.2.19 


Sec.  2.2.2.2.13 


Sec.  2.2.2.5.7 


Sec.  2.2.2.2.14 


Sec.  2.2.2.2.21 


Sec.  2  2.2.5.3 


Called  B 


Function 

Where  Described 

main 

Sec.  2.2.2.2.1 

Table  2.2-26:  logger_fsm  Information. 

2.2.2.2.16  logger_copying_state 

This  routine  defines  a  single  cycle  in  the  Data  Logger’s  copying  state.  It  reads  one  packet 
from  the  source  file  and  writes  it  to  the  destination  file. 
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1  Errors  1 

Error 

Reason  for  Error 

FIO_EOV_ERROR 

-  Copier  finished  writing  packet  # 

-  Copier  finished  readinq  packet  # 

FIO_EOF_ERROR 

-  Successfully  completed  copying  files 

-  Write  files  ran  out  of  space 

FIO  DRIVE  NOT  READY 

Tape  drive  is  not  ready  for  readinq 

loqqer  error 

Error  readinq  packet 

1  Calls  1 

■  Function 

Where  Described 

Sec.  2  2.2.5.2 

fio  read 

Sec.  2.1.4.2.2.7 

loader  error 

Sec.  2.2.2.5.3 

fio  write 

Sec.  2.1. 4  2.2.8 

continue  or  quit 

Sec.  2.2.21.5 

1  Called  Bv  1 

Function 

Where  Described 

loqqer  fsm 

Sec.  2.2.2.2.15 

Table  2.2-27:  logger_copying_state  Information. 


2.2.2.2.17  ini t Jogger^play back_state 

This  routine  initializes  state  variables  used  by  logger-playbackstate. 


_ 1 

Called  By  I 

Function 

Where  Described 

loqqer  continue 

Sec.  2.2.2.2.24 

Table  2.2-28:  iniMogger_piayback_state  Information. 


2.2.2.2.18  logger_playback_state 

This  routine  defines  a  single  cycle  in  the  playback  state.  In  the  playback  state,  the  Data 
Logger  gets  the  next  packet  from  the  logger  file,  filtering  out  certain  protocols  (i.e.  Stealth) 
if  necessary,  and  attempts  to  write  the  packet  out  to  the  CMC  Network. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

peek 

BOOL 

standard 

peek_pkt 

pointer  to  pointer  to 
fio  packet 

Sec.  2.1. 4.1.1  fiolib.h 
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Internal  Variables 


Variable 


drive  not  ready  count 


rotocol  number 


Where  Tvoedef  Declared 


standard 


standard 


Sec.  2.1. 4. 1.1  fiolib.h 


standard 


Return  Values 


Return  Value 


LoggerSuspended 


loaaer  state 


loggerActive 


LoggerState 


LooaerState 


LoggerState 


Meanin 


The  logger  is  in  the 
suspended  state 


The  current  state  of  the 


The  logger  is  in  the  active 
state 


Error 


FIO  EOV  ERROR 


FIO_EOF_ERROR 


FIO  DRIVE  NOT  READY  ERROR 


loaaer  error 


FIO  NET  WRITE  ERROR 


Errors 


Reason  for  Error 


Rnish?d  readina  packet  # 


Ran  out  of  packets  dunng  playback;  logger  is 
enter!  no  the  suspended  state 


Tape  dnve  is  not  re 


Error  readina  packet  for  playback 


Unexpected  error  on  playback 


Function 


fio  read 


loaaer  ms 


loaaer  suspend 


loaaer  error 


fio  error  stri 


rotocol  of 


on  time 


FIO  PACKET  TIME 


INC  SEND  COUNT 


et  fast  time  factor 


INC  LATE  COUNT 


INC  LATE  MARGIN 


INC  DROP  COUNT 


fio  write 


Calls 


Where  Described 


Sec.  2.1.4.2.2.7 


Sec.  2.2.2.5  2 


Sec.  2.2.2.2.30 


Sec.  2.2.2.5  3 


Sec.  2.1.4.2.4.2 


Sec.  2.2.2.5.4 


Sec.  2.2.2.6.10 


Sec.  2.1.4.1.1  fiolib.h  (macro  definition 


Sec.  2.2.1. 1  cmc.h  (macro  definition 


Sec.  2.2.2.6.4 


Sec.  2.2.1. 1  cmc.h  (macro  definition 


Sec.  2.2.1. 1  cmc.h  (macro  definition 


Sec.  2.2.1. 1  cmc.h  (macro  definition 


Sec.  2.1.4.2.2.8 


Called  B 


Function 

Where  Described 

looaer  fsm 

"Sec.  2.2.2.2.15 

loaaer  continue 

■Sec.  2.2.2.2.24 

Table  2.2-29:  logger_playback_state  Information. 
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2.2.2.2.19  logger_record_state 

This  routine  defines  a  single  cycle  in  the  data  logger’s  recording  state.  It  reads  one  packet 
from  the  network.  If  the  packet  is  a  run-time  command,  it  is  placed  in  the  RTC  queue. 
Otherwise,  it  is  written  out  to  the  logger  file. 


Variable 


kt 


rtc 


retval 


fane  reads 


advice  count 


dnve  not  ready  count 


Internal  Variables 


inter  to  fio  packet 


inter  to  fio  packet 


Where  Typedef  Declared 


Sec.  2.1. 4.1.1  fiolib.h 


Sec.  2.1. 4.1.1  fiolib.h 


standard 


standard 


standard 


standard 


Return  Values 


Return  Value 


loggerSuspended 


loggerActive 


LoggerState 


LoggerState 


Meanin 


The  logger  is  in  the 
suspended  state 


The  logger  is  in  the  active 
state 


Errors 

Error 

Reason  for  Error 

FIO  NO  PACKETS  AVAIL  ERROR 

Failino  to  receive  packets 

logger_error 

'  Unexpected  fio_read  error 
-  Error  writing  packet  during  record 

FIO_EOF_ERROR 

Ran  out  of  space  while  recording;  suspended 
logger 

FIO_DRIVE_NOT_READY_ERROR 

Tape  drive  is  not  ready  for  recording.  New  tape 
volume  required;  packets  are  being  lost 

Function 


fio  read 


belis 


loaoer  error 


rint  advice 


fio  error  stri 


rotocol  of 


INC  RCVDPVD  COUNT 


new  rtc 


FIO  PACKET  SIZE 


enqueue 


FIO  PACKET  TIME 


fio  write 


iNC  DROP  COUNT 


loaoer  suspend 


loaoer  ms 


Calls 


Where  Described 


Sec.  2.1.4.2.2.7 


Sec.  2.2.2.2.35 


Sec.  2.2.2.5.3 


Sec.  2.2.2.2.37 


Sec.  2.1.4.2.4.2 


Sec.  2.2.2.5.4 


Sec.  2.2.1. 1  cmc.h  (macro  definition 


Sec.  2.2.2.5.14 


Sec.  2.1 .4.1.1  fiolib.h  (macro  definition 


Sec.  2.2  2.3.6 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.1.4.2.2.8 


Sec.  2.2.1. 1  cmc.h  (macro  definition 


Sec.  2.2.2.2.30 


Sec.  2.2.2.5.2 
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1  Called  By  1 

Function 

Where  Described 

loaaer  fsm 

Sec.  2.2.2.2  .15 

Table  2.2*30:  logger_record_state  Information. 
2.2.2.2.20  logger_reset 

This  routine  resets  the  logger,  closes  all  the  files,  and  closes  the  RACAL  if  necessary. 


1  Calls  1 

Function 

Where  Described 

fio  close 

Sec.  2.1.4.2.2.12 

racal  close 

Sec.  2.2.2.4.2 

lodoer  messaoe  location 

Sec.  2.2.2.5.1 

Called  By 

Function 

Where  Described 

ccatcher 

Sec.  2.2.2.2.34 

main 

Sec.  2.2.2.2.1 

Table  2.2-31:  logger_reset  Information. 
2.2.2.2.21  logger_clock_tick 

This  routine  communicates  timing  information  to  the  client 


Internal 

Variables 

Variable 

Where  Typedef  Declared 

last  clocktick 

unsianed  Iona 

standard 

1  Calls  1 

Function 

Where  Described 

send  clock  tick 

Sec.  2.2.2.5.29 

1  Called  By  1 

Function 

Where  Described 

loaaer  fsm 

Sec.  2.2.2.2.15 

Table  2.2-32:  logger_clock_tick  Information. 

2.2.2.2.22  logger_op_error 

This  routine  performs  a  preliminary  check  for  errors  in  the  logger  operation.  It  makes  sure 
that  the  operation  requested  by  the  user  is  meaningful. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

op 

LoggerRTCType 

/simnet/common/include/prot 
ocol/p  loaaer.  h 

132 


BBN  Systems  and  Technologies 


Data  Logger  CSQ 


Returns 


Returns  pointer  to  char 


er  is  not  connected 


er  has  alrea 


er  is  already  in  active  mode 


Cant  activate  loaoer  which  has  not  been  started^ 


Cani  suspend  the  looaer  while  loaaerCo 


Loaoer  has  already  been  suspended 


Cam  suspend  loaoer  which  has  not  been  started 


Seekino  is  allowed  durino  loooerPlavback  onl 


"Chanoina  speed  is  allowed  duri 


Cannot  chanoe  loaoer  speed  when  usino  the  Racal 


Invalid  looaer  runtime  oommancT 


NULL 


I  MS;:!!? 

E 

B 
B 
E 


Called  B 


Function 

Where  Described 

command  reouest  handler 

Sec.  2.2.2.5.23 

handle  stdin  handler 

Sec.  2.2.2  5.8 

Table  2.2-33:  logger_op_error  Information. 

2.2.2.2.23  logger_connect 

This  procedure  changes  the  logger’s  state  to  logger  connected,  meaning  that  the  logger  has 
connected  to  a  client  in  server  mode.  This  proc^ure  takes  no  panuneters,  has  no  internal 
variables,  returns  no  values,  and  has  no  eirors. 


Called  B 


Function 

Where  Described 

connect  reouest  handler 

Sec.  2.2.2.5.21 

Table  2.2-34:  logger^connect  Information. 

2.2.2.2.24  logger_continue 

This  routine  changes  the  logger’s  state  to  logger  active,  meaning  the  logger  will  continue  to 
process  packets.  It  also  restarts  the  exercise  clock  if  the  logger  is  playing  back. 


133 


BBN  Systems  and  Technologies 


Data  Logger  CSQ 


Function 


loaaer  ms 


unfreeze  time 


exe  to  cmc  time 


racal  seek  to  time 


init  ioaaer  olayback  state 


er  playback  state 


set  time 


FIO  PACKET  TIME 


et  time 


fio  flush 


cmc  zero  status 


Calls 


Where  Described 


Sec.  2.2.2.5.2 


Sec.  2.2  2.6.9 


Sec.  2.2.2.6.1 


Sec.  2.2.2.4.12 


Sec.  2.2.2.2.17 


Sec.  2.2.2.2.18 


Sec.  2.2.2.6.6 


Sec.  2.1. 4.1.1  fiolib.h  (macro  definition 


Sec.  2.2.2.6.7 


Sec.  2.1.4.2.2.11 


Sec.  2.2.2.1.7 


Called  B 


Function 

Where  Described 

handle  stdin  rtc 

Sec.  2.2  2.5.8 

command  request  handler 

Sec.  2.2.2.5.23 

Table  2.2-35:  logger_continue  Information. 

2.2.2.2.25  logger_disconnect 

This  routine  changes  the  logger’s  state  to  logger  disconnected,  meaning  the  logger  is  no 
longer  conneaed  to  its  client. 


1  Calls  1 

Function 

Where  Described 

logger  stop 

Sec.  2.2.2.2.28 

disconnect  handler 

Sec.  2.2.2.5.22 

Table  2.2-36:  logger_disconnect  Information. 
2.2.2.2.26  logger_seek_relative 


This  routine  sets  the  playback  file  pointer  relative  to  its  current  location  based  on  "rtime" 
and  the  current  packet's  timestamp. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

rtime 

int 

standard 

relative  current  location 

BOOL 

standard 

Internal 

Variables 

Variable 

Where  Tvpedef  Declared 

cur  time 

int 

standard 

1  Errors  1 

Error 

Reason  for  Error 

FIO  ERROR 

Fio  seek  failed 
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1  Calls  1 

Function 

Where  Described 

fio  flush 

Sec.  2.1.4.2.2.11 

fio  seek 

Sec.  2.1.4.2.2.9 

loaoer  error 

Sec.  2.2  2.5.3 

set  time 

Sec.  2.2.2.6.6 

racal  seek  to  time 

Sec.  2.2.2.4.12 

racal  stop 

Sec.  2.2.2.4.11 

loaoer  msa 

Sec.  2.2.2.5.2 

Called  Bv 

Function 

Where  Described 

aoto  handler 

Sec.  2.2.2  5.9 

scan  handler 

Sec.  2.2.2.5.12 

command  .request  handler 

Sec.  2.2.2.5.23 

Table  2.2-37:  logger_seek_relative  Information. 
2.2.2.2.27  logger_speed 

This  routine  changes  the  playback  speed  of  the  logger.  The  playback  speed  is  set  to  the 
factor  of  the  parameter  factor. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

factor 

int 

standard 

1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

ft 

int 

standard 

1  Calls  1 

Function 

Where  Described 

set  fast  time  factor 

Sec.  2.2.2.6.3 

logger  msg 

Sec.  2.2.2  5.2 

time  string 

Sec.  2.2.2.6.11 

1  Called  Bv  1 

Function 

Where  Described 

handle  stdin  rtc 

Sec.  2.2.2.5.8 

command  request  handler 

Sec.  2.2.2.5.23 

Table  2.2-38:  logger_speed  Information. 
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2.2.2.2.28  logger_stop 

This  routine  stops  the  logger  and  places  the  finite  state  machine  into  the  loggerConnected 
state. 


1  Calls  1 

Function 

Where  Described 

cmc  report  status 

Sec.  2.2.2.1.8 

get  time 

Sec.  2.2.2.6.7 

_ Called  By _ 

Function  Where  Described 

logger  disconnect _ Sec.  2.2.2.2.25 

handle  stdin  rtc _ Sec.  2.2.2.5.8 

command  reguest  handler _ Sec.  2.2.2.5.23 


Table  2.2-39:  logger_stop  Information. 

2.2.2.2.29  logger_start 

This  routine  starts  the  Data  Logger  by  opening  the  files  for  reading  and  writing,  and  getting 
the  start  time  fix'  the  exercise  and  passing  it  back  to  the  client  Finally,  it  places  the  logger 
in  logger  suspended  state. 


Parameter 


files 


start  dt 


record!  n 


id 


comment 


IS  racal 


num  exercises 


exercises 


num  stdorotocols 


num  nstdorotocols 


record  voice 


record  sim 


lav  stealth 


Parameters 


e 


inter  to  file  info 


inter  to  LoggerTime 


BOOL 


inter  to  char 


inter  to  char 


BOOL 


short 


inter  to  char 


short 


short 


BOOL 


BOOL 


BOOL 


Where  Tvnedef  Declared 


Sec.  2.2.1 .8  util.h 


standard 


standard 


standard 


standard 


standard 


standard 


standard 


standard 


standard 


standard 


standard 


Return  Value 


FALSE 


TRUE 


Return  Values 


BOOL 


BOOL 


Meanin 


The  orocedure  failed 


The  procedure  succeeded; 
the  logger  is  started 


Error 


fio  error 


Errors 


Reason  for  Error 


-  Failed  to  open  files  for  loggerRecording 

-  Failed  to  ooen  files  for  loggerPlavback 
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Calls 

Function 

Where  Described 

cmc  protocol  types 

Sec.  2.2.21. 2 

loaaer  accept  pdus 

Sec.  2.2.2.2.12 

datetime  to  strinas 

Sec.  2.1. 3.2.5 

fio  file  header 

Sec.  2.1.4.2.3.3 

open  fio  files 

Sec.  2.2.2.2.10 

loaaer  error 

Sec.  2.2  2.5.3 

racal  open 

Sec.  2.2.2.4.1 

collect  racal  time  info 

Sec.  2.2.2.7.1 

reset  racal  time 

Sec.  2.2.2.4.8 

racal  start  recordin 


et  start  date  fiohdr 


et  start  time  fiohdr 


strinos  to  datetime 


fio  print  fiohdr 


reset  time 


fio  flush 


loaaer  suspend 


Sec.  2.2.2.A.9 


Sec.  2.1.4.2.3.15 


Sec.  2.1.4.2.3.19 


Sec.  2.1. 3.2.4 


Sec.  2.1.4.2.3.22 


Sec.  2.2.2.6.5 


Sec.  2.1.4.2.2.11 


Sec.  2.2.2.2.30 


Function 


init  loaaer  for  recordin 


init  loaaer  for  playback 


command  reauest  handler 


Called  B 


where  Described 


Sec.  2.2.2.2.9 


Sec.  2.2  2.2.8 


Sec.  2.2.2.5.23 


Table  2.2-40:  logger_start  Information. 
2.2.2.2.30  logger_suspend 

This  routine  places  the  finite  state  machine  into  the  loggerSuspended  state. 


Calls 


Function 

Where  Described 

bells 

Sec.  2.2.2.2.35 

loaaer  msa 

Sec.  2.2.2.5  2 

freeze  time 

Sec.  2.2.2.6  8 

racal  stop 

Sec.  2.2.2.4.11 

time  strina 

Sec.  2.2.2.6.11 

aet  time 

Sec.  2.2.2.6.7 

1  Called  By  1 

■  Function 

Where  Described 

f  '  1  1  li  II  lil^—l — 

Sec.  2.2.2.2.29 

loaaer  playback  state 

Sec.  2.2.2.2.18 

loaaer  record  state 

Sec.  2.2.2.2.19 

handler  stdin  rtc 

Sec.  2  2.2.5.8 

command  reauest  handler 

Sec.  2.2.2.5.23 

Table  2.2-41:  logger^suspend  Information. 
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2.2.2.2.31  logger_status 

This  routine  passes  out  information  about  the  Data  Logger’s  status. 


1  Parameters  1 

1  Parameter 

Type _ 

Where  Tvpedef  Declared 

p  loooer.h 

operation 

pointer  to  LoggerOperation 

p  logger.h 

state 

pointer  to  LoggerState 

is  racal 

pointer  to  int 

standard 

speed 

pointer  to  int 

standard 

start 

pointer  to  LoggerTIme 

offset 

pointer  to  int 

standard 

packets 

pointer  to  int 

standard 

file 

pointer  to  pointer  to  char 

standard 

project 

pointer  to  pointer  to  char 

standard 

comment 

pointer  to  pointer  to  char 

standard 

fio_head 

pointer  to  pointer  to 
fio  header 

Sec.  2. 1.4.1. 2  fioheader.h 

1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

ofs 

double 

standard 

1  Calls  1 

Function 

Where  Described 

qet  fast  time  factor 

Sec.  2.2.2.6  4 

get  time 

Sec.  2.2.2  6.7 

do  status  reply 

Sec.  2.2.2.5.28 

Table  2.2-42:  logger_status  Information. 
2.2.2.2.32  logger_get_state 

This  routine  gets  the  current  state  of  the  Data  Logger  Finite  State  Machine. 


Return 

Values 

Return  Value 

Type _ 

Meaning 

logger_state 

The  current  state  of  the 

Logger  Finite  State  Machine 

Called  By 

Function 

Where  Described 

avail  reguest  handler 

Sec.  2.2.2.5.20 

Table  2.2-43:  logger_get_state  Information. 
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2.2.2.2.33  logger_get_activity 

This  routine  gets  the  current  activity  of  the  Data  Logger. 


1  Return  Values  1 

Return  Value 

Type 

Meaning  I 

logger_activity 

1  Called  By  1 

Function 

Where  Described 

help  handler 

Sec.  2.2.2.5.10 

Table  2.2-44:  logger_get_activity  Information. 
2.2.2.2.34  ccatcher 

This  routine  ontrols  operation  of  the  Data  Logger  signal  interrupt  handler. 


1  Calls  1 

Function 

Where  Described 

loQoer  msQ 

Sec.  2.2.2.5.2 

cmc  report  status 

Sec.  2.2.2.1.8 

get  time 

Sec.  2.2.2.6.7 

loader  reset 

Sec.  2.2.2.2.20 

Table  2.2-45:  ccatcher  Information. 


2.2.2.2.35  bells 

This  routine  prints  bell  sounds. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

i 

int 

standard 

1  Called  By  1 

Function 

Where  Described 

logger  record  state 

Sec.  2.2.2.2.19 

logger  suspend 

Sec.  2.2.2.2.30 

Table  2.2-46:  bells  Information. 
2.2.2.2.36  print_command_line_help 

This  routine  prints  help  messages: 

Must  specify  one  of  the  following  flags: 

-c(opy  or  convert  data  files) 

-p(lay  tape  of  net  traffic) 

-r(ecord  net  traffic) 
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-h(elp) 

-s(erver  mode  standard  control  firom  PVD) 
-v(ersion  information) 

-q(uery  the  full  set  of  options) 


1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

1  proqname 

pointer  to  char 

standard 

1  Calls  1 

Function 

Where  Described 

loaaer  msq 

Sec.  2.2.2  5.2 

Called  By 

Function 

Where  Described 

process  parms 

Sec.  2.2.2.2  2 

Table  2.2-47:  print_command_line_help  Information. 
2.2.2.2.37  print_advice 

This  routine  prints  the  following  advice  as  necessary: 

There  are  no  vehicles  on  the  net.  If  so,  no  problem. 

The  Data  Analysis  net  has  become  disconnected  from  the  simulation 
netwoii:.  Check  the  transceiver  cable  connections. 

The  CMC  card  has  died.  Login  as  root 
Kill  ringstan  and  then  run  netstart. 


1  Calls  1 

■  Function 

Where  Described 

III  1 1 1  !■  II  ——^^1 

Sec.  2.2.2.5  2 

1  Called  By  1 

Function 

Where  Described 

loqqer  record  state 

Sec.  2.2.2.2.19 

Table  2.2-48:  print_advice  Information. 

2.2. 2.3  queue.c 

This  file  handles  the  Run-Time  Command  Queues  when  the  Data  Logger  is  in  server  mode. 

Incl  ies: 

<stdio.h> 

"queue.h" 


External  procedure  declarations: 
mallocO 
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Typedefs: 

queue_elt_type 

queue_type 


QUEUE_ELT 

QUEUE 


Global  Variables: 

QUEUE_ELT  firee_elts 

QUEUE  in_queue 

QUEUE  out_queue 


2. 2. 2. 3.1  queue_of 


This  routine  returns  the  address  of  the  free_queue,  out_queue,  or  in_queue  for  the  specified 
queue_id. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

queue  id 

int 

standard 

1  Return  Values  I 

Return  Value 

Meaninq 

&free  queue 

pointer  to  QUEUE 

The  address  of  free  queue 

&out  queue 

pointer  to  QUEUE 

The  address  of  out  queue 

&in  queue 

pointer  to  QUEUE 

The  address  of  in  queue 

NULL 

pointer  to  QUEUE 

Invalid  queue  id 

1  Called  Bv  1 

Function 

Where  Described 

enqueue 

Sec.  2.2.2.3.6 

dequeue 

Sec.  2.2.2.3.7 

queue  count 

Sec.  2.2  2.3.8 

Table  2.2-49:  queue_of  Information. 
2. 2. 2. 3. 2  new_queue_elt 

This  routine  creates  a  new  queue  element. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

qelt 

pointer  to  QUEUE  ELT 

Sec.  2.2.2.3  queue.c 

1  Return  Values  I 

Return  Value 

Meaninq 

qelt 

pointer  to  QUEUE_ELT 

pointer  to  the  new  queue 
element 

1  Called  Bv  1 

Function 

Where  Described 

enqueue 

Sec.  2.2.2.3.6 

Table  2.2-50:  new_queue_elt  Information. 
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2. 2. 2. 3. 3  free_queue_elt 

This  routine  frees  a  queue  element 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

aelt 

pointer  to  QUEUE  ELT 

Sec.  2.2.2.3  queue.c 

Called  By 

Function 

Where  Described 

dequeue 

Sec.  2.2.2.3.7 

Table  2.2>51:  free_queue_elt  Information. 
2. 2. 2. 3. 4  init_queues 

This  routine  initializes  the  queues  with  the  following  characteristics: 
free_elts  =  NULL 


free_queue.count  =  0 
free_queue.head  =  NULL 
free_queue.tail  =  NULL 


out_queue.count  =  0 
out_queue.head  =  NULL 
out_queue.tail  =  NULL 


in_queue.count  =  0 
in_queue.head  =  NULL 
in_queue.tail  =  NULL 


2. 2. 2. 3. 5  reinit_queues 


This  routine  reinitializes  the  queues. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

Btr 

pointer  to  char 

standard 

1  Calls  1 

Function 

Where  Described 

queue  count 

Sec.  2.2.2  3.8 

dequeue 

Sec.  2.2.2.3.7 

enqueue 

Sec.  2.2.2.3.6 

1  Called  By  1 

Function 

Where  Described 

main 

Sec.  2.2.2.2.1 

loqqer  init 

Sec.  2.2  2.2.5 

Table  2.2-52:  reinit_queues  Information. 
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2. 2. 2. 3. 6  enqueue 

Ths  routine  makes  an  entry  to  the  specified  queue. 


Parameters 


Parameter 


ueue 


tr 


inter  to  char 


Internal  Variables 


Where  Tvoedef  Declared 


standard 


standard 


Variable 


tr 


elt 


E7- 


irs 

irs 


inter  to  QUEUE 


inter  to  QUEUE  ELT 


Where  Tvoedef  Declared 


Sec.  2.2.2.3  oueue.c 


Sec.  2.2.2.3  Queue.c 


Function 


ueue  of 


new  queue  elt 


Calls 


Where  Described 


Sec.  2.2.2.3.8 


Sec.  2.2.2.3  2 


Called  B 


Function 

Where  Described 

loqqer  record  state 

Sec.  2.2.2.2.19 

send  rtc 

Sec.  2.2.2.5.17 

free  rtc 

Sec.  2.2.2.5.15 

Table  2.2>53:  enqueue  Information. 
2. 2. 2. 3. 7  dequeue 

This  routine  removes  an  entry  from  the  specified  queue. 


Parameters 


e 


int 


Internal  Variables 


Parameter 


ueue 


Where  Tvoedef  Declared 


standard 


Variable 


tr 


elt 


tr 


inter  to  QUEUE 


Inter  to  QUEUE  ELT 


inter  to  char 


Where  Tvoedef  Declared 


Sec.  2.2.2.3  queue.c 


Sec.  2.2.2.3  queue.c 


standard 


Return  Value 


tr 


Return  Values 


inter  to  char 


Function 


ueue  of 


free  queue  elt 


Calls 


Where  Described 


Sec.  2.2.2.3.8 


Sec.  2.2.2.3.3 
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Called  B 


Where  Described 

Sec.  2.2.2.2.14 
Sec.  2.2.2.5.14 
Sec.  2.2.2.5.16 


Function _ 

logger  put  remote  rtc 

new  rtc _ 

receive  rtc 
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Standard  Procedures: 

perrorO 

exitO 

sleepO 

strcatO 

Defines: 

TERMINAL_LINE 

SEC.FIELD 

MIN_FIELD 

HOUR.FIELD 

DAYJFELD 

File  descriptor  for  terminal  line  to  racal  recorder  declaration: 
racal_fd 

2. 2. 2. 4.1  racal_open 

This  routine  opens  the  racal,  setting  the  line's  baud  rate  to  4800  baud. 


Parameters 


Parameter 


Variable 


open  mask 


dev  name 


att  term  buffer 


Error 


perror 


Function 


send  to  racal 


Function 


er  start 


I  Bn 


Where  Tvoedef  Declared 


standard 


Internal  Variables 


e 


int 


inter  to  char 


struct  termio 


IBT^ 

m 

IliS 


Where  Tvoedef  Declared 


standard 


standard 


standard 


Errors 


Reason  for  Error 


-  Failed  to  read  terminal  characteristics  for 
device 

•  Failed  to  read  ATT  style  terminal 
characteristics 

-  Failed  to  set  output  AON/XOFF  control  for 
device 


Calls 


Where  Described 


Sec.  2.2.2.4.4 


Called  B 


Where  Described 


Sec.  2.2.2.2.29 


Table  2.2-56:  racal_open  Information. 
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2. 2. 2. 4. 2  racal_close 
This  routine  closes  the  racal. 


1  Called  By  1 

Function 

Where  Described 

logger  reset 

Sec.  2.2.2.2.20 

Table  2.2>57:  racal  close  Information. 


2. 2. 2. 4. 3  get_from_racal 


This  routine  reads  and  returns  a  terminated  line  of  text  from  the  racal  recorder.  For 
efficiency,  the  NO_DELAY  is  open  and  reply  is  accumulated  over  sevoal  calls. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

in  char 

char 

standard 

i 

int 

standard 

1  1  ll'li  1 

char 

standard 

pointer  to  char 

standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

reply_ptr 

pointer  to  char 

terminated  line  of  text  from  the 
racal  recorder 

1  Called  By  1 

Function 

Where  Described 

get  racal  time 

Sec.  2.2.2.4.7 

Table  2.2-58:  get_from_racal  Information. 
2. 2. 2. 4. 4  send  to  racal 


This  routine  sends  a  command  string  to  the  racal  recorder  open  on  fd. 
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1  Called  Bv  1 

Function 

Where  Described 

racal  open 

Sec.  2.2.2.4.1 

aet  racal  time 

Sec.  2.2.2.4.7 

reset  racal  time 

Sec.  2.2.2.4.8 

racal  start  recordina 

Sec.  2.2.2  4.9 

racal  start  plavina 

Sec.  2.2.2.4.10 

racal  stop 

Sec.  2.2.2.4.11 

racal  seek  to  time 

Sec.  2.2.2.4.12 

Table  2.2-59:  send  to  racal  Information. 


2. 2. 2. 4. 5  racal  to  cmc 


This  routine  accepts  the  time  string  returned  by  the  racal  and  returns  the  correspcmding  time 
in  cmc  milliseconds.  The  string  format  is  "001  RTyymmddhhmmssNOlS".  Note  that 
strings  in  the  form  ”001  A\015"  may  need  weeding  out. 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

time  strina 

pointer  to  char 

standard 

1  Internal  Variables  1 

Variable 

Tvoe 

Where  Tvpedef  Declared 

second 

int 

standard 

minute 

int 

standard 

hour 

int 

standard 

day 

int 

standard 

cmc  msec 

int 

standard 

1  Return  Values  1 

Return  Value 

Meaning 

cmc_msec 

1  int 

1 

timejstring  in  corresponding 
cmc  milliseconds 

1  Called  Bv  1 

Function 

Where  Described 

aet  racal  time 

Sec.  2  2.2.4.7 

Table  2.2-60:  racal  to  cmc  Information. 


2 . 2 . 2 . 4 . 6  seconds_to_racai_string 

This  routine  converts  passed  integer  seconds  into  a  string  in  the  form  yytnmddhhmmss. 
Note  that  this  routine  will  handle  no  more  than  24  hours,  and  that  the  returned  string  will  be 
destroyed  on  the  next  call  to  this  routine. 


147 


BBN  Systems  and  Technologies 


Data  Logger  CSQ 


Table  2.2-61:  seconds_to_racal_string  Information. 
2. 2. 2. 4. 7  get_racal_time 

This  routine  returns  immediately  with  the  time  in  milliseconds. 


Variable 


Internal  Variables 


e 


inter  to  char 


Where  Typedef  Declared 


standard 


Return  Value 


racal  to  cmctrepi 


IBTiX 


Return  Values 


Meanin 


time  in  milliseconds 


Function 


send  to  racal 


et  from  racal 


racal  to  cnx: 


Calls 


Where  Described 


Sec.  2.2.2.4.4 


Sec.  2.2.2.4.3 


Sec.  2.2.2  4.5 


Called  B 


Function 

Where  Described 

racal  seek  to  time 

Sec.  2.2.2.4.12 

Table  2.2-62:  get_racal_time  Information. 
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2. 2. 2. 4. 8  reset_racal_tiine 

This  routine  sets  the  racal's  real-time  clock  to  0.  Note  that  the  racal's  clock  continues  to 
run. 


1  Calls  1 

Function 

Where  Described  I 

send  to  racal 

Sec.  2.2.2.4.4  1 

Called  By 

Function 

Where  Described 

loaaer  start 

Sec.  2.2.2.2.29 

Table  2.2>63:  reset_racal_time  Information. 
2. 2. 2. 4. 9  racal_start_recording 

This  routine  starts  the  racal  recording. 


1  Calls  1 

Function 

Where  Described 

send  to  racal 

Sec.  2.2.2.4.4 

Table  2.2-64:  racal_start_recording  Information. 
2.2.2.4.10  racal_start_playing 

This  routine  starts  the  racal  playing. 


1  Calls  1 

Function 

Where  Described 

send  to  racal 

Sec.  2.2.2.4.4 

Table  2.2-65:  racal_start_playing  Information. 
2.2.2.4.11  racai_stop 
This  routine  stops  the  racal. 


1  Calls  1 

Function 

Where  Described 

send  to  racal 

Sec.  2.2  2.4.4 

Called  By 

Function 

Where  Described 

lOQoer  suspend 

Sec.  2.2.2.2.30 

loQoer  seek  relative 

Sec.  2.2.2.2.26 

Table  2.2-66:  racal_stop  Information. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

seek  time 

int 

standard 

racal  time  at  start 

int 

standard 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

offset 

int 

standard 

loaaer  time 

int 

standard 

current  racal  time 

int 

standard 

okJ  racal  time 

int 

standard 

racal  time  strina 

pointer  to  char 

standard 

char 

standard 

■  seconds  to  racal  strinqO 

pointer  to  char 

standard 

1  Calls  1 

Function 

Where  Described 

seconds  to  racal  strina 

Sec.  2.2.2.4.6 

send  to  racal 

Sec.  2.2  2.4.4 

aet  racal  time 

Sec.  2.2.2.4.7 

1  Called  By  1 

Function 

Where  Described 

loaaer  seek  relative 

Sec.  2.2.2.2.26 

loader  continue 

Sec.  2.2.2.2.24 

Table  2.2-67:  racal  seek  to  time  Information. 


2. 2. 2. 5  rtc.c 

This  file  handies  the  processing  of  run-time  commands  from  the  user  for  both  the  stand¬ 
alone  Data  Logger  and  the  server  Data  Logger. 
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Includes: 

<stdio.h> 

<sysAoctl.h> 

"fiolib.h" 

"fioheader.h" 

"network.h" 

"pjogger.h" 

"p_nuin.h" 

"p_assoc.h" 

"p_p2p.h" 

"global.h" 

"logger.h" 

"queue.h" 

"rtc.h" 

"timer.h" 

"util.h" 

Standard  Procedure  Declarations: 
mallocO 
strncpyO 

Static  Procedure  Declarations: 

handle_stdin_rtc() 

goto_hindler() 

help_handler() 

info~handler() 

scan~  handlerO 

recefve_rtc() 

send_rtc() 

init_p<lu() 

init~apdu() 

avari_request_handler() 

conne^ct_request_handler() 

disconnect_handier() 

command_request_handler() 

parse_start_fileJnfo() 

status"  request_handler() 

do_infbrmation() 

do_status_reply 

Defines: 

CMC_MSECONDS_PER_SECOND 

PDUKindO 

STRING_LENGTH 

Global  Variable  Declarations: 
loggerMCA 
logger_is_connected 
clientSimAddr 
loggers  imAddr 
msgbufl256] 
send_to_network 

loggerJump_table[loggerLastPDUKind] 
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Typedef: 

jump_struct  JUMP_ENTRY 
2 . 2 . 2 .5 . 1  iogger_message_iocatioii 

This  routine  determines  the  place  to  send  logger  messages:  stdout/stdeir  or  network. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared  I 

msa  to  net 

BOOL 

standard  1 

Called  By 


Function 

Where  Described 

main 

Sec.  2.2.2.2.1 

logger  reset 

Sec.  2.2.2.2.20 

init  logger  for  server 

Sec.  2.2.2.2.6 

Table  2.2-68:  logger_message_location  Information. 
2. 2. 2. 5. 2  logger_msg 


This  routine  sends  a  message  to  the  user. 
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Function 


cmc  reorot  status 


main 


rocess  Damns 


logger  suspend 


nnt  command  line  hei 


rint  advice 


ccatcher 


logger  seek  relative 


er  Diavback  state 


logger  record  state 


logger  continue 


555 


init  logger  for  playback 


init  logger  for  recordin 


open  fio  files 


init  logger  for  copvin 


handle  stdin  rtc 


help  handler 


handle  remote  rtc 


Called  B 


V/here 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Sec.  2. 


Described 


2.2.1. 8 


2.2.2.1 


2.22.2 


2.2.2.30 


2.2.2.36 


2.2.2.37 


2.2.2.34 


2.2.2.26 


2.2.2.27 


2.2.2.18 


2.2.2.19 


2.2.2.24 


2.2.2.16 


2.2.28 


2.2.2.9 


2.2.2.10 


2.22.7 


2.2.58 


2.2.5.10 


2.2.5.13 


Table  2.2-69:  Iogger_nisg  Information. 


2. 2. 2. 5. 3  logger_error 

This  routine  sends  an  error  message  to  the  user. 
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1  Called  By  1 

Function 

Where  Described 

cmc  accept 

Sec.  2.2.2.1.3 

cmc  reject 

Sec.  2.2.21. 4 

process  parms 

Sec.  2.2.2.2  2 

looaer  seek  relative 

Sec.  2.2.2.2.26 

Sec.  2.2.2.2.29 

loaoer  playback  state 

Sec.  2.2.2.2.18 

loader  record  state 

Sec.  2.2.2.2.19 

loader  accept  pdus 

Sec.  2.2.2.2.12 

loader  fsm 

Sec.  2.2.2.2.15 

loader  copyina  state 

Sec.  2.2.2.2.16 

open  fio  files 

Sec.  2.2.2.2.10 

init  loaoer  for  copyina 

Sec.  2.2  2.2.7 

handle  stdin  rtc 

Sec.  2.2.2.5  8 

command  request  handler 

Sec.  2.2.2.5.23 

Table  2.2-70:  logger_error  Information. 
2. 2. 2. 5. 4  protocol_of 


This  routine  returns  the  specified  fio_packet's  protocol 


r 


Parameter 


rtc 


et  root  protocol 


Parameters 


idt: 

ins 


inter  to  fio  packet 


BOOL 


Where  Tvpedef  Declared 


Sec.  2. 1.4. 1.1  fiolib.h 


standard 


Variable 


apdu 


du 


rotocol  number 


Internal  Variables 


inter  to  AssociationPDU 


I  pointer  to  PointToPointPDU 


AssociationUserProtocol 


Where  Tvpedef  Declared 


assoc,  h 


assoc,  h 


Return  Value 


rotocol  number 


Return  Values 


AssociationUserProtocol 


Meanin 


the  protocol  of  the  packet 


Function 


loqaer  record  state 


er  playback  state 


loaoer  aet  remote  rtc 


Called  B 


Where  Described 


Sec.  2.2.2.2.19 


Sec.  2.2.2.2.18 


Sec.  2.2.2.2.13 


Table  2.2-71:  protocol_of  Information. 
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2. 2. 2. 5. 5  rtc_size 

This  routine  returns  the  size  of  the  specified  RTC  APDU. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

rtc 

pointer  to  fio  packet 

Sec.  2. 1.4. 1.1  fiolib.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

apdu 

pointer  to  AssociationPDU 

p  assoc,  h 

1  Return  Values  1 

Return  Value 

Meanina 

sizeof(AssociationPDU  + 
(unsigned)  apdu-> 
dataLenath) 

unsigned 

the  size  of  the  APDU 

1  Called  By  1 

Function 

Where  Described 

send  rtc 

Sec.  2.2.2.5.17 

Table  2.2-72:  rtc  size  Information. 


2. 2. 2. 5. 6  init  rtc 


This  routine  initializes  the  rtc  module. 


1  Calls  1 

Function 

Where  Described 

AssocCreateMCA 

Sec.  2.20.1  See  MCC  CSCI  SDD 

AssocGetSimAddress 

Sec.  2.20.1  See  MCC  CSCI  SDD 

Called  By 

Function 

Where  Described 

main 

Sec.  2.2.2.2.1 

Table  2.2-73:  init_rtc  Information. 

2. 2. 2. 5. 7  handle_rtc 

This  routine  handles  processing  of  input  from  the  user,  either  from  stdin  or  the  network, 
during  execution  of  the  logger. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

is  server 

BOOL 

standard 

Calls 

Function 

Where  Described 

handle  remote  rtc 

Sec.  2.2.2.5.13 

handle  stdin  rtc 

Sec.  2.2  2.5.8 
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1  Called  Bv  1 

Function 

Where  Described 

loqqer  fsm 

Sec.  2.2.2.2.15 

Table  2.2-74:  handle_rtc  Information. 


2. 2. 2. 5. 8  handle_stdin_rtc 

This  routine  handles  processing  of  runtime  messages  from  stdin  (t.e.,  the  user)  when  the 
logger  is  in  command-line  mode, 
c  -  Continue 
f  -  Forward  scan 
g  -  Goto 
h  -  Help 

i  -  Information  about  logger  status 
p  -  Pause 
r  -  Reverse  scan 
s  -  Speed 


I  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

inoutrSTRING  LENGTH  +  11 

char 

standard 

next  char 

char 

standard 

msq 

pointer  to  char 

standard 

readfds 

int 

standard 

writefds 

int 

standard 

Errors 

Error 

Reason  for  Error 

loqqer  error 

Unrecoqnized  command  sequence 

Calls 

Function 

Where  Described 

loqqer  op  error 

Sec.  2.2.2  2  22 

loqqer  error 

Sec.  2.2.2  5.3 

loqqer  msq 

Sec.  2.2.2.5  2 

loqqer  continue 

Sec.  2.2.2.2.24 

scan  handler 

Sec.  2.2.2.5.12 

qoto  handler 

Sec.  2.2.2.5.9 

help  handler 

Sec.  2.2.2.5.10 

info  handler 

Sec.  2.2.2.5.11 

loqqer  stop 

Sec.  2.2.2.2.28 

loqqer  suspend 

Sec.  2.2.2.2.30 

loqqer  speed 

Sec.  2.2.2.2.27 

Called  By 

Function 

Where  Described 

handle  rtc 

Sec.  2.2.2.5.7 

Table  2.2-75:  handle  stdin  rtc  Information. 
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2. 2. 2. 5. 9  goto_handler 

This  routine  handles  processing  of  Goto  runtime  commands. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

input 

pointer  to  char 

standard 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

c 

char 

standard 

bufr321 

char 

standard 

seconds 

int 

standard 

dseconds 

double 

standard 

Calls 

Function 

Where  Described 

logger  seek  relative 

Sec.  2.2.2.2.26 

Called  Bv 

Function 

Where  Described 

handle  stdin  rtc 

Sec.  2.2.2.5.8 

Table  2.2>76:  goto_handler  Information. 


2.2.2.5.10  help_handler 


This  routine  handles  processing  of  Help  runtime  commands. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

input 

pointer  to  char 

standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

str 

pointer  to  char 

standard 

activity 

int 

standard 

1  Calls  1 

■  Function 

Where  Described 

Sec.  2.2.2.2.33 

■  logger  msg 

Sec.  2.2.2.5  2 

■  Called  Bv  ■ 

Function 

Where  Described 

handle  stdin  rtc 

Sec.  2.2.2  5.8 

Table  2.2-77:  help_handler  Information. 
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2.2.2.5.11  info_handler 

This  routine  handles  processing  of  Info  runtime  commands. 


Parameters 


Parameter 


inter  to  char 


Internal  Variables 


Where  Tvoedef  Declared 


standard 


Variable 


activi 


ooeration 


state 


IS  racal 


soeed 


start 


offset 


ackets 


file 


roiect 


comment 


fio  head 


Where  Tvoedef  Declared 


LoaoerActivit 


LoaoerOoeration 


LoaoerState 


int 


int 


LoQoerTime 


int 


int 


inter  to  char 


inter  to  char 


inter  to  char 


inter  to  fio  header 


IIS 

IIS 

IIS 

IIS 


standard 


standard 


standard 


standard 


standard 


standard 


standard 


Sec.  2. 1.4. 1.2  fioheader.h 


Called  B 


Function 

Where  Described 

handle  stdin  rtc 

Sec.  2.2.2.5.8 

Table  2.2-78:  info_handler  Information. 
2.2.2.5.12  scan_handier 

This  routine  handles  processing  of  Forward  and  Reverse  Scan  runtime  commands. 
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Called  B 


Function 

Where  Described 

handle  stdin  rtc 

Sec.  2.2  2.5.8 

Table  2.2>79:  scan_handler  Information. 

2.2.2.5.13  handle_remote_rtc 

This  routine  handles  processing  of  runtime  messages  from  the  client  when  the  logger  is  in 
server  mode. 


Variable 


\wm 


Internal  Variables 


e 


void 


inter  to  no  racket 


inter  to  AssociationPDU 


inter  to  LoaaerPDU 


Where  Typedef  Declared 


standard 


Sec.  2. 1.4. 1.1  fiolib.h 


assoc,  h 


Function 


receive  rtc 


loaoer  ms 


free  rtc 


Calls 


Where  Described 


Sec.  2.2.2.5.16 


Sec.  2.2.2.5  2 


Sec.  2.2.2.5.15 


Function 


init  loaoer  for  server 


handle  rtc 


Called  B 


Where  Described 


Sec.  2.2.2.2.6 


Sec.  2  2.2.5.7 


Table  2.2-80:  handle_remote_rtc  Information. 
2.2.2.5.14  new_rtc 

This  routine  gets  a  new  runtime  commandbuffer. 
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1  Called  By  1 

Function 

Where  Described 

loader  record  state 

Sec.  2.2.2.2.19 

loader  aet  remote  rtc 

Sec.  2.2.2.2.13 

loaaer  msa 

Sec.  2.2.2.5.2 

loader  error 

Sec.  2.2.2  5.3 

avail  reauest  handler 

Sec.  2.2.2.5.20 

connect  reauest  handler 

Sec.  2.2.2.5.21 

disconnect  handler 

Sec.  2.2.2.5.22 

command  reauest  handler 

Sec.  2.2.2.5.23 

status  reauest  handler 

Sec.  2.2.2.5.25 

send  clock  tick 

Sec.  2.2  2.5  .29 

Table  2.2*81:  new  rtc  Information. 


2.2.2.5.15  free_rtc 

This  routine  frees  a  runtime  commandbuffer. 


Parameter 


rtc 


Parameters 


inter  to  fio  oacket 


Where  Tvnedef  Declared 


Sec.  2.1. 4.1.1  fiolib.h 


Function 


enaueue 


Calls 


Where  Described 


Sec.  2.2.2.3.6 


Function 


loaaer  out  remote  rtc 


handle  remote  rtc 


Called  B 


Where  Described 


Sec.  2.2.2.2.14 


Sec.  2.2.2.5.13 


Table  2.2-82:  free_rtc  Information. 

2.2.2.5.16  receive_rtc 

This  routine  gets  the  next  runtime  command,  if  there  is  one,  from  the  IN_QUEUE. 
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1  Called  Bv  1 

Function 

Where  Described 

handle  remote  rtc 

Sec.  2.2.2.5.13 

Table  2.2-83:  receive  rtc  Information. 


2.2.2.5.17  send  rtc 


This  routine  places  the  rtc  response  in  the  OlJT_QlJElJE  so  it  can  be  written  out  on  the  net 
at  the  next  available  moment 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

rtc 

pointer  to  fio  packet 

Sec.  2.1. 4.1.1  fiolib.h 

1  Calls  1 

Function 

Where  Described 

rtc  size 

Sec.  2.2.2.5.5 

enqueue 

Sec.  2.2.2.3.6 

1  Called  Bv  1 

Function 

Where  Described  1 

loqqer  msq 

loqqer  error 

Sec.  2.2.2.5.3 

avail  request  handler 

Sec.  2.2.2.5.20 

connect  reauest  handler 

Sec.  2.2.2.5.21 

disconnect  handler 

Sec.  2.2.2.5.22 

command  request  handler 

Sec.  2.2.2.5.23 

status  request  handler 

Sec.  2.2.2.5.25 

send  clock  tick 

Sec.  2.2.2.5.29 

Table  2.2-84:  send_rtc  Information. 

The  following  routines  (2.2.2.5.18  through  2.2.2.5.29)  handle  run-time  requests  and 
replies  from  the  client  when  the  logger  is  in  server  mode.  Run-time  fiojjackets  have  the 
following  structure: 

fio_packet_header 
APDU  header 
Logger  PDU 

2.2.2.5.18  init_apdu 

This  routine  initializes  the  APDU  header  portion  of  the  run-time  command  fioj)ackets.  All 
Logger  PDU's  are  sent  via  Association  datagram  PDU's.  The  following  characteristics 
wiU  be  constant  for  all  Logger/Client  PDU's. 
version:  loggerProtocolVersionCurrent 
kind:  datagramAPDUKind 
dataLength:  datajen 
userProtocol:  loggerProtocolNumber 
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1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

apdu 

pointer  to  AssodationPDU 

D  assoc,  h 

data  len 

unsianed 

standard 

Called  By 

Function 

Where  Described 

loaaer  msa 

Sec.  2.2  2.5.2 

loaaer  error 

Sec.  2.2.2.5.3 

connect  request  handler 

Sec.  2.2.2.5.21 

disconnect  handler 

Sec.  2.2.2.5.22 

command  reauest  handler 

Sec.  2.2.2.5.23 

status  reauest  handler 

Sec.  2.2.2.5.25 

send  clock  tick 

Sec.  2.2.2.5.29 

do  information 

Sec.  2.2.2.5.26 

Table  2.2-85:  init_apdu  Information. 

2.2.2.5.19  init_pdu 

This  routine  initializes  the  Logger  PDU's  portion  of  teh  runtime  command  fiojjackets  with 
the  following  characteristics: 

version:  loggerProtocolVersionCurrent 
kind:  kind 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

pdu 

pointer  to  LoqqerPDU 

p  loqqer.h 

destination 

pointer  to  SimulationAddress 

address. h 

kind 

int 

standard 

1  Called  By  I 

Function 

Where  Described 

avail  request  handler 

Sec.  2.2.2.5.20 

connect  request  handler 

Sec.  2.2.2.5.21 

disconnect  handler 

Sec.  2.2.2.5.22 

command  request  handler 

Sec.  2.2.2.5.23 

do  clock  tick 

Sec.  2.2.2.5.27 

Sec.  2.2.2.5.28 

Table  2.2-86:  init_pdu  Information. 

2.2.2.5.20  avail_request_handler 

This  routine  handles  AvailRequest  PDU's.  The  client  sends  out  an  AvailRequest  PDU  to 
find  out  which  Data  Loggers  are  available  for  connection  in  server  mode.  If  available,  the 
Data  Logger  must  respond  with  an  AvailReply  PDU. 
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Parameter 


mrtc 


Parameters 


inter  to  fio  packet 


Where  Tvoedef  Declared 


Sec.  2. 1.4. 1.1  fiolib.h 


Internal  Variables 


Variable 


rtc 


u 


du 


inter  to  AssooationPDU 


inter  to  LogaerPDU 


Where  Typedef  Declared 


Sec.  2. 1.4. 1.1  fiolib.h 


assoc,  h 


Calls 

Function 

Where  Described 

new  rtc 

Sec.  2.2.2.5.14 

Ioaoer  oet  state 

Sec.  2.2.2.2.32 

init  Pdu 

Sec.  2.2.2.5.19 

init  apdu 

Sec.  2.2.2.5.18 

send  rtc 

Sec.  2.2.2.5.17 

Table  2.2-87:  avail_request_handler  Information. 

2.2.2.5.21  connect_request_handier 

This  routine  handles  ConnectRequest  PDU's.  The  client  sends  out  an  ConnectRequest 
PDU  to  the  particular  Data  Logger  it  wishes  to  connect  to.  The  Data  Logger  must  respond 
with  either  an  Ack  PDU  or  a  PDU. 


Parameter 


inrtc 


lETE 

irs 


Parameters 


inter  to  fio  packet 


Where  Typedef  Declared 


Sec.  2.1. 4.1.1  fiolib.h 


Variable 


rtc 


|7 


du 


requester 


IDT? 

irs 
irs 
ns 

IIS 


Internal  Variables 


e 


inter  to  fio  packet 


inter  to  AssociationPDU 


inter  to  LoqqerPDU 


inter  to  SimulationAddress  I  address.h 


Where  Typedef  Declared 


Sec.  2.1. 4.1.1  fiolib.h 


assoc,  h 


ir _ 

lltlilM! 


Function 


new  rtc 


ioaoer  connect 


init  pdu 


init  apdu 


send  rtc 


Calls 


Where  Described 


Sec.  2.2.2.5.14 


Sec.  2.2.2.2.23 


Sec.  2.2.2.5.19 


Sec.  2.2.2.5.18 


Sec.  2.2.2.5.17 


Table  2.2-88:  connect_request_handler  Information. 
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2.2.2.5.22  disconnect  handier 


This  routine  disconnects  the  Data  Logger  from  the  client.  The  client  sends  out  an 
DisconnectRequest  PDU  when  preparing  to  tominate  its  Data  Logger  connecdtMi.  The 
Data  Logger  responds  with  an  Ack  PDU  and  disconnects. 


I  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

inrtc 

pointer  to  fio  packet 

Sec.  2.1. 4.1.1  fiolib.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

rtc 

pointer  to  fio  packet 

Sec.  2.1. 4.1.1  fiolib.h 

apdu 

pointer  to  AssodationPDU 

p  assoc,  h 

pdu 

pointer  to  LooaerPDU 

1  Calls  1 

Function 

Where  Described 

new  rtc 

Sec.  2.2.2.5.14 

loQoer  disconnect 

Sec.  2.2.2.2.25 

init  Ddu 

Sec.  2.2.2.5.19 

init  aodu 

Sec.  2.2.2.5.18 

send  rtc 

Sec.  2.2.2.5.17 

Table  2.2-89:  disconnect  handler  Information. 


2.2.2.5.23  command_request_handler 

This  routine  handles  runtime  command  requests  frcrni  the  client.  Currently  defined  are: 
Start 
Continue 
Suspend 
Stop 

Seek_relative 

Play_speed 


1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

1  inrtc 

pointer  to  fio  packet 

Sec.  2.1. 4.1.1  fiolib.h 

1  Internal  Variables  1 

1  Variable 

Type 

Where  Tvpedef  Declared  1 

pointer  to  LoqqerPDU 

rtc 

pointer  to  fio  packet 

Sec.  2. 1.4. 1.1  fiolib.h 

apdu 

pointer  to  AssodationPDU 

p  assoc,  h 

pdu 

pointer  to  LooaerPDU 

p  loooer.h 

files 

file  info 

Sec.  2.2. 1.8  util.h 

msa 

pointer  to  char 

standard 

red 

pointer  to  LoggerStartRTC 
pointer  to  LoggerSeekRTC 
pointer  to  LoooerSpeedRTC 

p_logger.h 

seconds 

int 

standard 

dseconds 

double 

standard 
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Table  2.2-90:  command_request_handier  Information. 
2.2.2.5.24  parse_start_fiIe_info 


This  routine  translates  logger  PDU's  containing  start  commands  into  file_info  structures  to 
be  passed  to  logger_start. 


Parameter 


red 


files 


Parameters 


e 


I  DOinter  to  LoqqerStartRTC 


Dointer  to  file  Info 


Where  Typedef  Declared 


Sec.  2.2.1. 8  util. 


Variable 


len 


Internal  Variables 


e 


unsiqned 


int 


Where  Typedef  Declared 


standard 


standard 


Called  B 


Function 

Where  Described 

command  request  handler 

Sec.  2.2.2.5.23 

Table  2.2-91:  parse_start_nie_info  Information. 

2.2.2.5.25  status_request_handier 

This  routine  passes  back  status  information  to  the  client  in  response  to  StatusR^uest 
PDU's.  The  client  sends  out  an  StatusRequest  PDU  when  requesting  information  about  its 
current  operating  status.  The  Data  Logger  must  respond  with  a  StatusReply  PDU. 
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2.2.2.5.26  do_information 

This  routine  builds  a  logger  PDU  containing  information  to  be  passed  back  to  the  client. 
This  information  can  either  be  about  the  results  of  some  request  for  logger  action  (i.e.,  an 
error  message)  or  be  some  purely  informational  message. 


Parameter 


du 


is  error 


errms 


r; 


Parameters 


I  Dointer  to  LoaaerPDU 


BOOL 


inter  to  char 


Where  Tvpedef  Declared 


standard 


standard 


Variable 


Internal  Variables 


e 


pointer  to 

LodoerlnformationVariant 


Where  Tvpedef  Declared 


p_logger.h 


Function 


init  pdu 


Calls 


Where  Described 


Sec.  2.2.2.5.19 


Function 


loaaer  ms 


loaaer  error 


Called  B 


Where  Described 


Sec.  2  2.2.5.2 


Sec.  2.2  2.5.3 


Table  2.2-93:  do  information  Information. 
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2.1,2.S.n  do_clock_tick 

This  routine  builds  the  ClockTick  PDU  that  the  logger  uses  to  pass  the  current  exercise  time 
back  to  its  client. 


Parameters 


Parameter 


du 


sec  offset 


start  dt 


n 


irs 


inter  to  LoaaerPDU 


unsioned  Ion 


inter  to  LoaoerTime 


Where  Tvoedef  Declared 


standard 


Variable 


var 


Internal  Variables 


e 


pointer  to 

LodoerClockTlckVariant 


lEin 


Where  Tvoedef  Declared 


p Jogger. h 


Function 


init  Ddu 


Calls 


Where  Described 


Sec.  2.2.2.5.19 


Called  B 


Function 

Where  Described 

send  clock  tick  I 

Sec.  2.2.2.5.29 

Table  2.2*94:  do_clock_tick  Information. 

2.2.2.5.28  do_statu^_reply 

This  routine  builds  the  StatusReply  PDU  that  the  logger  uses  to  reply  to  a  client's  request 
for  status  information. 
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Calls 


_ Called  B _ 

Table  2.2-95:  do_status_repIy  Information. 
2.2.2.5.29  send_clock_tick 
This  routine  sends  the  clock  tick  to  the  client 


Where  Described 

Sec.  2.2.2.5.25 


Function _ 

status  request  handler 


Where  Described 

Sec.  2.2.2.5.19 
Sec.  2.2.2.2.31 


Function 
init  pdu 
loqqer  status 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

msec  offset 

unsigned  long 

standard 

start  dt 

pointer  to  LoqqerTlme 

p  logger,  h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

rtc 

pointer  to  fio  packet 

Sec.  2. 1.4. 1.1  fiolib.h 

apdu 

pointer  to  AssociationPDU 

p  assoc,  h 

pdu 

pointer  to  LooaerPDU 

p  logger. h 

sec  offset 

unsigned  long 

standard 

dsec  offset 

double 

standard 

Calls 

Function 

Where  Described 

new  rtc 

Sec.  2.2.2.5.14 

do  clock  tick 

Sec.  2.2.2.5.27 

init  apdu 

Sec.  2.2.2.5.18 

send  rtc 

Sec.  2.2.2.5.17 

Called  By 

Function 

Where  Described 

logger  clock  tick 

Sec.  2.2.2.2.21 

Table  2.2-96:  do_status_reply  Information. 


2. 2. 2. 6  timer.c 

This  file  handles  the  Data  Logger's  timer.  It  provides  the  speed-up  and  freeze  functions  of 
the  Data  logger  during  playback.  Note  that  are  three  times: 

(1)  Real  time,  i.e.,  clock  time 

(2)  CMC  time  is  the  time  on  the  CMC  driver 

(3)  Exercise  time  is  the  real  time  elapsed  from  the  start  of  the  exercise  to  the  time 
stamp  on  the  current  packet  ( it  may  be  adjusted  by  a  certain  factor) 
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Note  also  that  it  is  only  necessary  that  the  time  since  the  last  change  in  rate  be  used  to 
modify  the  exercise  time,  since  Ae  CMC  time  will  be  changed  every  time  the  rate  changes. 

There  are  several  interactions  between  the  procedures; 

-  freeze_time('  and  unfreeze_time()  affect  only  time_of_freeze. 

-  set_fast_tiine_factor()  affects  time_of_fast  and  fast_fa^ctor  and  is 
dependent  upon  time_of_freeze 

-  set_time()  ^fects  tiine_of  fast  and  time  of_freeze  if  set. 

-  get  timeO  is  affected  tw  time  of  fast,  tfihe" of  freeze,  and 

fast_factor.  ~ 

It  is  important  to  note  that  on_tiiiie()  depends  upon  the  16  bit  Network  clock  for 
timekeeping  purposes.  According  to  Network  Interface  Library  documentation,  a  call  to 
get  time  must  be  made  at  least  once  every  60  seconds  for  the  l^bit  network  clock  to  remain 
accurate. 

Includes: 

<stdio.h> 

"sys/types.h> 

"global.h" 

"cmc.h" 

"timer.h" 

Variable  Declarations: 
fast_factor 
time_of_fast 
time_of_freeze 

2. 2. 2. 6.1  exe_to_cmc_time 

This  routine  converts  the  exercise  time  to  CMC  time. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

exe  time 

int 

standard 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

ct 

int 

standard 

Return  Values 

Return  Value 

Type 

Meaning 

ct 

int 

The  cmc  time  of  the  specified 
exercise  time. 

Called  By 

Function 

Where  Described 

logger  continue 

Sec.  2.2.2,2.24 

Table  2.2-97:  exe  to  cmc  time  Information. 
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2. 2. 2. 6. 2  cmc_to_exe_time 

This  routine  converts  the  CMC  time  to  exercise  time. 


Parameters 


Parameter 


cmc  time 


Where  Tvoedef  Declared 


standard 


Variable 


et 


lElT^ 


internal  Variables 


e 


Where  Tvoedef  Declared 


standard 


Return  Value 


et 


iE27!] 


Return  Values 


Meanin 


The  exercise  time  of  the 
ied  cmc  time. 


Function 


et  time 


freeze  time 


unfreeze  time 


on  time 


Called  B 


Where  Described 


Sec.  2.2.2.6.7 


Sec.  2.2.2.6.8 


Sec.  2.2  2.6.9 


Sec.  2.2.2.6.10 


Table  2.2>98:  cmc_to_exe_time  Information. 
2. 2. 2. 6. 3  set_fast_time_factor 

This  routine  sets  the  CMC  time  to  exercise  time  conversion  factor. 


Parameters 


Parameter 


factor 


Where  Tvoedef  Declared 


standard 


Variable 


ect 


internal  Variables 


e 


Where  Tvoedef  Declared 


standard 


Return  Value 


ect 


Return  Values 


Function 


et  time 


cmc  settime 


r 


Calls 


Where  Described 


Sec.  2.2.2  6.7 


Sec.  2.2.2.1.11 


Called  B 


Function 

Where  Described 

logger  speed 

Sec.  2.2.2.2.27 

Table  2.2-99:  set  fast  time  factor  Information. 
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2. 2. 2. 6. 4  get_fast_time_factor 

This  routine  gets  the  CMC  time  to  exercise  time  conversion  factor. 


1  Called  By  1 

Function 

Where  Described 

loQoer  status 

Sec.  2.2.2.2.31 

loqqer  playback  state 

Sec.  2.2.2.2.18 

Table  2.2-100:  get_fast_time_factor  Information. 

2. 2. 2. 6. 5  reset_time 

This  routine  resets  the  CMC  time  to  0.  the  fast_factor  to  1,  the  time_of_fast  to  0,  and  the 
time_of_freeze  to  0. 


1  Calls  1 

Function 

Where  Described 

cmc  settime 

Sec.  2.2.2.1.11 

Called  By 

Function 

Where  Described 

logger  start 

Sec.  2.2.2.2.29 

Table  2.2-101:  reset  time  Information. 


2. 2. 2. 6. 6 


set  time 


This  routine  changes  time  to  begin  playing  at  the  passed  Exercise  time. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

exe  time 

int 

standard 

1  -  1 

Return 

Values 

Return  Value 

Type 

Meaning 

exejime 

int 

the  Exercise  time;  procedure 
was  successful 

Calls 

Function 

Where  Described 

cmc  settime 

Sec.  2.2.2.1.11 

Called  By 

Function 

Where  Described 

logger  seek  relative 

Sec.  2.2.2.2.26 

logqer_continue 

Sec.  2.2.2.2.24 

Table  2.2-102:  set  time  Information. 
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2. 2. 2. 6. 7  get_time 

This  routine  gets  the  current  Exercise  time. 


Return  Values 


Return  Value 


time  of  freeze 


cmc_to_exe_time 
(cmc gettime32) 


Type 


int 


int 


Meaning 


the  time  of  freeze 


the  current  Exercise  time 


Calls 


Function 


cmc  to  exe  time 


cmc gettime32 


Where  Described 


Sec.  2.2  2.6.2 


Sec.  2.2.2.1.10 


Function 


Called  By 


logger  suspend 


logger  status 


ccatcher 


logger  stop 


get  time 


set  fast  time  factor 


Where  Described 


Sec.  2.2.2.2.30 


Sec.  2.2.2.2.31 


Sec.  2.2.2.2.34 


Sec.  2.2.2.2.28 


Sec.  2.2.2  2.7 


Sec.  2.2.2.6  3 


Table  2.2-103:  get_time  Information. 
2. 2. 2. 6. 8  freeze_time 

This  routine  fineezes  the  Exercise  time. 


1  Return  Values  1 

Return  Value 

Type 

time_of_freeze 

int 

the  Exercise  time  at  the  time  of 
freeze 

1  Calls  1 

Function 

Where  Described 

cmc  to  exe  time 

Sec.  2.2.2.6  2 

cmc  gettime32 

Sec.  2.2.2.1.10 

1  Called  By  1 

Function 

Where  Described 

logger  suspend 

Sec.  2.2.2.2.30 

Table  2.2-104:  freeze_time  Information. 


i 
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2.2.2. 6.9  unfreeze_tiine 

This  routine  unfreezes  the  Exercise  time. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

et 

int 

standard 

Return  Values 

Return  Value 

Type 

Meaning 

et 

int 

the  Exercise  time  at  the  time  of 
unfreezing 

Calls 

Function 

Where  Described 

cmc  settime 

Sec.  2.2.2.1.11 

exe  to  cmc  time 

Sec.  2.2.2.6.1 

Called  Bv 

Function 

Where  Described 

logger  continue 

Sec.  2.2.2.2.24 

Table  2.2<105:  unfreeze_time  Information. 

2.2.2.6.10  on_time 

This  routine  takes  an  Exercise  time,  converts  it  to  CMC  time,  and  returns  TRUE  if  the 
resulting  time  has  not  passed. 
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1  Called  By  1 

Function 

Where  Described 

loqqer  playback  state 

Sec.  2.2.2.2.18 

Table  2.2-106:  on  time  Information. 


2.2.2.6.11  time_string 


This  routine  converts  an  integer  time  into  a  string. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

msec 

int 

standard 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

time  buff 641 

char 

standard 

1  Return  Values  1 

Return  Value 

Meaninp 

time  buf 

pointer  to  char 

the  time  strinq 

1  Called  By  1 

Function 

Where  Described 

loqqer  suspend 

Sec.  2.2.2.2.30 

loqqer  speed 

Sec.  2.2.2.2.27 

Table  2.2-107:  time_string  Information. 


2. 2. 2. 7  user.c 

This  file  provides  the  user  interface  and  help  functions  for  the  stand-alone  Data  Logger. 

Includes; 

<stdio.h> 

<ctype.h> 

<sys/ioctl> 

<sys/types.h> 

<sys/stat.h> 

Tiolib.h" 

"pjogger.h" 

"global.h" 

"util.h" 

"user.h" 


Imported  Procedure  Declarations: 

fopenO 

freeO 

mallocO 

perrorO 

strncpyO 

strrchrf) 
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strtokO 

Variable  Declarations; 
eimo 

sys_errlist[] 

msgbuf[MAX_LINE_LEN+l] 

helpbuflMAX_LINE_LEN+l] 

input[MAX_LINE_LEN+l] 

help_stream 

Static  Procedure  Declarations: 

collect_diskfile_info() 

collect~tapefilO"^^0 

user_putstr()  ” 

proinpt_user() 

help_function() 

can_access_file() 

vlaunchO 


Defines: 

Formatting  Strings; 

INDENT.STRING 

PROMPT_INDENT 

REPLY.INDENT 

HELP.INDENT 

Help  Strings: 

HELP_RACAL_STARmME_INFO 

HELP_CONTIGUOUS_DISKINFO 

HELP_FEXNAME_DISKINFO 

HELP_FILESIZE_DISKINFO 

HELP_LOOPING_DISKINFO 

HELP_CONTINUOUS_TAPEINFO 

HELP_DRIVES_TAPEINFO 

HELP_SIZE_TAPEINFO 

HELP_MEDIUM_FILEINFO 

HELP_CONTINlJE_OR_QUIT 

HELP.EXERCISEIDJNFO 

HELP.HOHEADERJNFO 

HELP_NUMEXERCISES_INFO 

HELP_PROTOCOL_TYPE_INFO 

HELP_YES_OR_NO 

HELP_STRING_CHAR 

VALID_EXAMPLE_CHAR 

HELP_FILE_NAME 

Tape  Strings: 

R625SMT0 

R625SMT1 

MAX_LINE_LEN 
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2. 2. 2. 7.1  collect  racal  time  info 


This  collects  information  from  the  user  about  the  racal  recorder. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

racal  time 

pointer  to  int 

standard 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

done 

BOOL 

standard 

1  Calls  1 

Function 

Where  Described 

user  putstr 

Sec.  2.2.2.7.10 

prompt  user 

Sec.  2.2.2.7.11 

strino  to  seconds 

Sec.  2.1. 3.2.3 

1  Called  By  I 

■  Function 

Where  Described 

II  '  1  1  li  11 

Sec.  2.2.2.2.29 

Table  2.2-108:  collect_racal_time_info  Information. 

2. 2. 2. 7. 2  collect_fiofile_info 

This  routine  collects  information  from  the  user  about  the  type  of  fiofile  to  open  for  reading 
or  writing. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

files 

pointer  to  file  info 

Sec.  2.2. 1.8  util.h 

dfitnm 

pointer  to  char 

standard 

write 

BOOL 

standard 

debug 

BOOL 

standard 

query  all 

BOOL 

standard 

Function 


prompt  user 


collect  diskfile  info 


collect  tapefile  info 


Function 


init  logger  for  playback 


Calls 


Where  Described 


Sec.  2.2.2.7.11 


Sec.  2.2.2.7.3 


Sec.  2.2.2.7.4 


Called  By 


init  loqoer  for  recording 


init  logger  for  copying 


Where  Described 


Sec.  2.2.2  2.8 


Sec.  2.2.2.2.9 


Sec.  2.2.2  2.7 


Table  2.2-109:  collect_fiorile_info  Information. 
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l.l.lJ.Z  collect_diskfile_info 

This  routine  collects  information  from  the  user  about  the  specified  disk  tile. 


Parameters 


Parameter 


files 


dfitnm 


write 


uerv  all 


IE17? 
irs 
\n 


inter  to  file  info 


inter  to  char 


BOOL 


BOOL 


BOOL 


Where  Typedef  Declared 


Sec.  2.2.1. 8  util.h 


standard 


standard 


standard 


standard 


Variable 


done 


nvolumes 


filesz 


filenm 


s 


Internal  Variables 


BOOL 


int 


int 


mt 


Dointerto  char 


pointer  to  char 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


standard 


standard 


Error 


er  WARNING: 


IS! 


Errors 


Reason  for  Error 


Specified  file  already  exists 


Function 


rompt  user 


user  putstr 


can  access  file 


es  or  no 


Calls 


Where  Described 


Sec.  2.2.2.7.11 


Sec.  2.2.2.7.10 


Sec.  2.2.2.7.14 


Sec.  2.2  2.7.9 


Called  B 


Function 

Where  Described 

collect  fiofile  info 

Sec.  2.2.2.7  2 

Table  2.2*110:  collect_diskfile_info  Information. 
2. 2. 2. 7. 4  collect_tapefile_info 

This  routine  collects  information  from  the  user  about  the  specified  tape  file. 
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1  Calls  1 

Function 

Where  Described 

prompt  user 

Sec.  2.2.2.7.11 

user  putstr 

Sec.  2.2.2.7.10 

Called  Bv 

Function 

Where  Described 

collect  fiofile  info 

Sec.  2.2  2.7.2 

Table  2.2>111:  collect_tapenie_info  Information. 
2.2.2.7.S  collect  cmcsubscribe  info 


This  routine  collects  information  about  the  specified  exercises  from  the  user. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

Sim  protocol 

pointer  to  BOOL 

standard 

voice  protocol 

pointer  to  BOOL 

standard 

num  exercises 

pointer  to  short 

standard 

exercises 

pointer  to  char 

standard 

num  stdprotocols 

pointer  to  short 

standard 

num  nstdprotocols 

pointer  to  short 

standard 

debuq 

BOOL 

standard 

query  all 

BOOL 

standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

Strf321 

char 

standard 

id 

int 

standard 

i 

int 

standard 

1  Calls  1 

Function 

Where  Described 

prompt  user 

Sec.  2.2.2.7.11 

user  putstr 

Sec.  2.2.2.7.10 

1  Called  By  1 

Function 

Where  Described 

init  loqqer  for  recordinq 

Sec.  2.2.2  2.9 

Table  2.2-112:  collect  cmcsubscribe  info  Information. 
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coUect_rioheader_info 

This  routine  collects  information  from  the  user  for  the  DataProbe  header  in  the  fio_header. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

file  id 

pointer  to  char 

standard 

fileid  sz 

int 

standard 

comment 

pointer  to  char 

standard 

comment  sz 

int 

standard 

project 

pointer  to  char 

standard 

project  sz 

int 

standard 

Calls 

Function 

Where  Described 

prompt  user 

Sec.  2.2.2.7.11 

Called  Bv 

Function 

Where  Described 

init  topper  for  recordinq 

Sec.  2.2.2.2.9 

Table  2.2- 113:  collect_fioheader_info  Information. 


2. 2. 2. 7. 7  coliect_playback_info 

This  routine  collects  information  from  the  user  about  whether  to  play  back  the  stealth 
protocol. 


Parameters 


Parameter 


lav  stealth 


uerv  all 


lEIT] 

irs 


inter  to  BOOL 


BOOL 


Where  Typedef  Declared 


standard 


standard 


Function 


rompt  user 


user  Dutstr 


Calls 


Where  Described 


Sec.  2.2.2.7.11 


Sec.  2.2.2.7.10 


Function 


init  loader  for  playback 


Called  B 


Where  Described 


Sec.  2.2.2  2  .8 


Table  2.2-114:  collect_playback_info  Information. 
2. 2. 2. 7. 8  continue_or_quit 


This  routine  asks  the  user  whether  they  want  to  continue  or  quit 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

str 

pointer  to  char 

standard 

help  str 

pointer  to  char 

standard 
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Variable 


retval 


Return  Value 


retval 


Internal  Variables 


BOOL 


Return  Values 


BOOL 


Where  Tvoedef  Declared 


standard 


Meanin 


If  retval  =  TRUE,  user  wants  to 
continue; 

If  retval  >  FALSE,  user  wants 
to  Quit 


Function 


rompt  user 


Calls 


Where  Described 


Sec.  2.2.2.7.11 


Called  B 


Function 

Where  Described 

loQoer  copvinq  state 

Sec.  2.2.2.2.16 

Table  2.2-115:  continue_or_quit  Information. 
2. 2. 2. 7. 9  yes_or_no 

This  routine  asks  the  user  "yes  or  no". 
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Function 


mam 


init  lOQoer  for  playback 


init  loaaer  for  recordin 


init  loaaer  for  copyin 


collect  diskfile  info 


help  function 


Called  B 


Where  Described 


Sec.  2.2.2.2.1 


Sec.  2.2.2  2.8 


Sec.  2.2.2  2.9 


Sec.  2.2.2.2.7 


Sec.  2.2.2.7.3 


Sec.  2.2.2.7.12 


Table  2.2-116:  yes_or_no  Information. 
2.2.2.7.10  user_putstr 
This  routine  formats  output. 


Parameter 


str 


indent  level 


newline 


IfITi] 

irs 


inter  to  char 


int 


BOOL 


Parameters 


Where  Typedef  Daclared 


standard 


standard 


standard 


Variable 


Internal  Variables 


e 


Where  Typedef  Declared 


standard 


Function 


collect  racal  time  info 


collect  tapefile  info 


collect  cmcsubscribe  info 


collect  playback  info 


rompt  user 


help  function 


collect  diskfile  info 


n 


Called  B 


Where  Described 


Sec.  2.2.2.7.1 


Sec.  2.2.2.7.4 


Sec.  2.2.2  7.5 


Sec.  2.2.2  7.7 


Sec.  2.2.2.7.11 


Sec.  2.2.2.7.12 


Sec.  2.2.2.7.3 


Table  2.2-117;  user  putstr  Information. 
2.2.2.7.11  prompt_user 

This  routine  prompts  the  user. 
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Variable 


done 


buffe 


mammsMSsmi 


Internal  Variables 


e 


BOOL 


char 


inter  to  char 


Where  Tvoedef  Declared 


standard 


standard 


standard 


Function 


user  putstr 


help  function 


Calls 


Where  Described 


Sec.  2.2.2.7.10 


Sec.  2.2.2.7.12 


Function 


collect  racal  time  info 


collect  fiofile  info 


collect  diskfile  info 


collect  tapefile  info 


collect  cmcsubscnbe  info 


collect  playback  info 


continue  or  ouit 


es  or  no 


collect  fioheader  info 


Called  B 


Where  Described 


Sec.  2.2.2.7.1 


Sec.  2.2.2  7.2 


Sec.  2.2.2.7.3 


Sec.  2.2.2  7.4 


Sec.  2.2.2.7.5 


Sec.  2.2.21  n 


Sec.  2.2  2.7.8 


Sec.  2.2.21  a 


Sec.  2.2.2.7.6 


Table  2.2- 118:  prompt_user  Information. 
2.2.2.7.12  help_function 

This  routine  handles  the  on-line  help  function. 


Parameter 


help  str 


Parameters 


inter  to  cnar 


Where  Typedef  Declared 


standard 


Variable 


done 


iof 


Internal  Variables 


e 


BOOL 


BOOL 


inter  to  char 


Where  Typedef  Declared 


standard 


standard 


standard 


Function 


user  putstr 


es  or  no 


Calls 


Where  Described 


Sec.  2.2.2.7.10 


Sec.  2.2.2  7.9 


|7 


Function 


rompt  user 


Called  B 


Where  Described 


Sec.  2.2.2.7.11 


Table  2.2-119:  help_function  Information. 
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2.2.2.7.13  init_user 

This  routine  initializes  the  user. 


1  Called  By  I 

Function 

Where  Described 

main 

Sec.  2.2.2.2.1 

Table  2.2-120:  init  user  Information. 


2.2.2.7.14  can_access_rile 

This  routine  checks  the  path  name  of  the  file  to  find  out  if  the  specified  file  exists  and 
returns  TRUE  if  if  it  does. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

path 

pointer  to  char 

standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

stat  but 

struct  stat 

standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

msqbuf 

pointer  to  char 

the  specified  file  exists 

NULL 

pointer  to  char 

the  specified  file  does  not 
exist 

1  Errors  1 

Error 

Reason  for  Error 

Logger  WARNING 

-  Cant  access  specified  tile 

-  Specified  file  is  a  directory 

1  Called  By  I 

Function 

Where  Described 

collect  diskfile  info 

Sec.  2.2.2.7.3 

Table  2.2-121:  can_access_rile  Information. 

2.2.2.7.15  vlaunch 

This  routine  is  a  method  of  executing  a  command  to  the  UNDC  shell;  it  is  a  fast  version  of 
launch.  The  first  item  in  the  command  must  be  the  complete  pathname  of  a  program. 
ccmd[  128]  is  the  mugified  copy  of  cmd.  prog  is  the  file  to  be  EXECed.  argv[128]  is  the 
arguments  to  prog. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

cmd 

pointer  to  char 

standard 
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I  Internal  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

ccmdri281 

char 

standard 

£rpg 

pointer  to  char 

standard 

pointer  to  char 

standard 

1  count 

int 

standard 

1  Return  Values  1 

Return  Value 

Meaning 

0 

int 

launch  was  successful 

-1 

int 

launch  failed 

Table  2.2-122:  vlaunch  Information. 


2. 2. 2. 8  util.c 

This  file  contains  low  level  utilities  used  by  the  Data  Logger. 

Includes: 

<stdio.h> 

"global.h" 

"utiLh" 

Imported  procedure  declarations: 
freeO 


2. 2. 2. 8.1  initjilejnfo 

This  routine  sets  the  following  file  characteristics: 
nvolumes  =  0 
curvol  =  1 
contig  =  FALSE 
covert  =  0 
looping  =  FALSE 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

files 

pointer  to  file  info 

Sec.  2.2.1. 8  util.h 

free  mem 

BOOL 

standard 

1  Internal  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

i 

int 

standard 

1  Called  By  1 

Function 

Where  Described 

init  loader  for  playback 

Sec.  2.2.2.2.8 

init  loaaer  for  recordina 

Sec.  2  2.2.2.9 

init  loader  variables 

Sec.  2.2.2.2.4 

command  reauest  handler 

Sec.  2.2.2.5.23 

Table  2.2-123:  init_file_info  Information. 
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2. 2. 2.9 


logfilt.c 


This  file  is  used  to  direct  the  CMC  driver  card.  It  contains  the  filters  that  are  downloaded  to 
the  CMC  card  while  the  logger  is  running.  The  following  PDU's  are  allowed  to  pass 
through  the  filter 

1)  All  packets  belongmg  to  the  'protocolLogger'  protocol. 

2)  All  packets  belonging  to  the  'protocolSim'  protocol  if  the  logger  has  explicitely 
ask^  for  their  MulticastGroupID  (exercise  ID). 

3)  All  packets  belonging  to  the  current  version  of  other  standard  or  proprietary 
protocols  if  the  logger  has  explicitely  asked  for  that  protocol. 


Includes: 

■'p_All.h" 

"enpif.h" 

"network.h" 

"netfilter.h" 

"cmc.h" 

2. 2. 2. 9.1  dojnit 

This  routine  is  called  by  the  CMC  card  to  initialize  the  link  with  the  logger. 

2. 2. 2. 9. 2  do_packet_from_host 

This  routine  filters  a  packet  from  the  host. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared  I 

pkt 

pointer  to  short 

standard  1 

Return  Values 

Return  Value 

Type 

Meaning 

SEND  PACKET 

int 

PDU  was  accepted 

Table  2.2-124:  do_packet_from_host  Information. 
2. 2. 2. 9. 3  do_packet_from_network 

This  routine  filters  a  packet  from  the  network. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

pkt 

pointer  to  NetworkPacket 

network.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

apdu 

pointer  to  register 

Association  POU 

p_assoc.h 

protocol 

register  int 

standard 

exercise 

register  int 

standard 

retval 

int 

standard 
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Return  Values 


Return  Value 


retval 


Meanln 


if  retval  =  SEND_PACKET.  the 
PDU  was  accepted; 
if  retval  =  FREE_PACKET.  the 
PDU  was  not  accepted 


Calls 


Function 

Where  Described 

GET  DATA  PTR 

network.h 

ACCEPT  EXERCISE 

Sec.  2.2.1. 1  cmc.h  (macro  definition 

ACCEPT  PROTOCOL 

Sec.  2.2.1. 1  cmc.h  (macro  definition 

Table  2.2-125:  do_packet_froin_network  Information. 
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APPENDIX  A:  FIO  DATA  FILE  FORMAT 


The  data  file  is  composed  of  a  series  of  24k  blocks,  as  illustrated  in  Figure  A-1  The  first 
24k  block  is  called  the  f  io_f  ile_header  and  is  defined  in  "fioheader.h".  The  next 
24k  blocks  are  the  f  io  records,  also  called  the  Data  Blocks.  A  variable  number  of 
these  24k  blocks  are  each  fcnmatted  as  shown  in  Figure  A-2.  Each  record  is  comprised  of 
a  4  byte  header  (consisting  of  a  length  field)  and  a  variable  number  of  fio  packets,  each  of 
arbitrary  length.  The  f  io  record  is  declared  in  "fiofile.h". 


Figure  A-1:  SIMNET  Data  File  Structure 


Fio  Packets 
(of  arbitrary  length) 


Figure  A-2:  File  Record  Structure 
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The  f  io_header  includes  the  following  fields: 


f io_header 

dp_header 

tape_type 

run_nuinber 

pro ject_id 

comment 

date_of_run 

tape_number 

bits_per_word 

frame_si2e 

header_si2e 

da  t  e_o  f  _c  op  y 

time_of_run 

t ime_of _launch 

f iolib_version_chksum 
ma jor_rev 
minor_rev 
user_info_of f set 
user_info_bytes 
ui_heap 

f ile_id 
nexercise_ids 
exercise__ids 
command  str 


-  Data  Probe  header  consists  of: 

-  ADP,  SIM,  etc. 

-  SIMNET,  etc. 

—  String  from  user 
--  When  created 

—  Volume  number  of  tape 


-  For  checking  compatability 

--  Datalogger  version  #  used  to  record 

-  The  offset  to  the  start  of  user  defined  area 

-  Number  of  bytes  in  user  defined  area 

-  3rd  to  last  block:  user  defined  info 

-  The  file  id  number 

-  The  number  of  exercises 

-  Which  exercises  to  record 

-  Char  string  typed  to  Unix  prompt 


The  total  number  of  remaining  24k  blocks  in  the  series  varies  from  file  to  file  and  is  derined 
in  the  variable  F  I0_REC0RD_BL0CKS.  Each  of  these  data  blocks  is  called  an 
f  io_record.  The  f  io_record  consists  of  enough  variable  length  packets  to  fill  the 
24k  data  block.  The  f  io_record  is  defuied  in  "fiofile.h"  and  includes  the  following 
fields: 


fio_record 

record_header  —  4  byte  length  field 

-  The  remainder  of  the  record  is  filled  with  Packets  of  the  following  format: 


f io_packet_header 
time 

num_bytes 

from 

to 

type 

data 


“  Packet  header  consists  of: 

--  time  stamp  for  play  back 
--  #  of  bytes  in  data  portion 

-  from  NetworkAddress 

-  to  NetworkAddress 

-  ethemet  packet  protocol  type 
-  Packet  data 
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APPENDIX  B:  PVD  DATA  LOGGER  COMMUNICATIONS  PROTOCOL 

This  protocol  is  intended  to  handle  the  communication  needs  of  the  PVD  and  the  Data 
Logger  when  the  Data  Logger  is  being  controlled  by  fiom  the  PVD  in  'server'  mode. 
Logger/PVD  PDUs  share  the  CMC  network  with  the  standard  simulatitm  protocol  PDUs. 
However,  Logger/PVD  communications  take  place  on  a  unique  multi-caste  address 
consisting  of  the  following; 

MulticastGroupID  0 

AssociationUserProtocol  loggerProtocolNumber 

The  three  phases  of  Logger/PVD  communications  are: 

1)  Connect  Phase 

2)  Command  Phase 

3)  Disconnect  Phase 

During  the  first  phase,  the  Logger  will  respond  to  all  PDU’s  arriving  on  its  Multi-cast 
group.  Thereafter  it  responds  only  to  PDU's  which  are  explicitely  directed  to  it. 

In  the  discussion  of  the  Logger/PVD  protocol  outlined  below,  it  is  assumed  that  the  Logger 
and  PVD  will  be  using  the  services  of  the  Association  Protocol  for  their  communications. 
All  PDU's  are  assumed  to  be  sent  via  the  POINT_TO_POINT_DATAGRAM  (ptp 
datagram)  service  unless  otherwise  stated. 


constant  loggerAcceptAll  256 

constant  loggerMaxCommentSz  24 

constant  loggerMaxErrorStringSz  128 

constant  loggerMaxExerciselDs  8 

constant  loggerMaxFileNameSz  64 

constant  loggerMaxFileVolumes  2 

constant  loggerMaxHostNameSz  32 

constant  loggerMaxPro jIDSz  7 

constant  loggerMulticastGroupID  0 


PDUKIND  loggerAvailRequestPDUKind 

OVERVIEW 

The  loggerAvailRequestPDUKind  is  sent  by  the  PVD  while  preparing  to  connect  to 
a  Logger.  It  is  sent  on  the  Logger/PVD  multi-cast  address  using  the  broadcast  Datagram 
(as  opposed  to  the  ptpDatagram)  service. 

All  Loggers  which  are  operating  in  server  mode  and  which  are  not  already  ccmnected  to  a 
PVD  must  respond  with  a  '  loggerAvailReplyPDUKind'  PDU.  Both  the  Request 
and  the  Reply  are  sent  using  the  ptpDatagram  service.  The  PVD  must  wait  a  reasonable 
amount  of  time  for  the  Loggers  to  respond  before  assuming  no  other  Loggers  are  out  there. 

PDUKIND  loggerConnectRequestPDUKind 
OVERVIEW 

The  PVD  sends  a  '  loggerConnectPDUKind '  to  the  particular  Logger  to  which  it 
wants  to  connect  using  the  ptpDatagram  service  of  the  Association  Protocol. 
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The  Logger  responds  with  either  a  '  loggerAckPDUKind '  or  a 
'  loggerNakPDUKind '  using  the  ptpDatagram  service. 

PDUKIND  loggerCommandRequestPDUKind 
OVERVIEW 

The  PVD  sends  the  loggerCommandRequestPDUKind  to  the  Logger  to  which  it  is 
connected  in  order  to  specify  runtime  commands.  The  PVD  uses  the  ptpDatagram  service 
of  the  Association  Protocol.  The  following  runtime  commands  are  currently  defined  in  the 
PVD/Logger  protocol; 

START 

CONTINUE 

SUSPEND 

STOP 

SEEK_RELATIVE 

PLAY_SPEED 

PDUKIND  loggerStatusRequestPDUKind 
OVERVIEW 

The  PVD  sends  a  '  loggerStatusRequestPDUKind '  to  the  Logger  to  which  it  is 
connected  to  gather  information  about  its  current  operating  status.  The  PVD  uses  the 
ptpDatagram  service  of  the  Association  Protocol. 

The  Logger  responds  with  a  '  loggerStatusReplyPDUKind '  using  the  ptpDatagram 
service. 

PDUKIND  loggerDisconnectRequestPDUKind 
OVERVIEW 

The  PVD  sends  a  '  loggerDisconnectPDUKind  ’  to  the  Logger  to  which  it  is 
connected  to  terminate  its  connection.  The  PVD  uses  the  ptpDatagram  service  of  the 
Association  Protocol. 

The  Logger  responds  with  a  '  loggerAckPDUKind '  using  the  ptpDatagram  service. 


PDUKIND  loggerAckPDUKind 
OVERVIEW 

The  Logger  uses  this  PDU  to  reply  to  successful  PVD  requests. 

PDUKIND  loggerNakPDUKind 
OVERVIEW 

The  Logger  uses  this  PDU  to  reply  to  failed  PVD  requests. 


PDUKIND  loggerAvailReplyPDUKind 
OVERVIEW 

The  Logger  uses  this  PDU  to  reply  to  PVD  Availability  Requests. 

PDUKIND  loggerStatusReplyPDUKind 
OVERVIEW 

The  Logger  uses  this  PDU  to  reply  to  PVD  Status  Requests. 
PDUKINTD  logger  Inf  ormationPDUKind 
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OVERVIEW 

The  Lx>gger  uses  this  PDU  to  communicate  unsolicited  information  to  the  PVD  using  the 
ptpDatagram  service. 

PDUKIND  loggerClockTickPDUKind 

OVERVIEW 

The  Logger  uses  this  PDU  to  communicate  timing  information  to  the  PVD  using  the 
ptpDatagram  service. 


Kinds  of  loggerProtocol  PDUs: 

“  loggerProtocol  PDUs  with  which  the  PVD  sends  requests  to  the  Logger. 

type  LoggerPDUKir^d  enum  (8)  { 

loggerAvailRequestPDUKind  (1)  , 

loggerConnectRequestPDUKind, 

loggerCommandRequestPDUKind, 

loggerStatusRequestPDUKind, 

loggerDisconnectRequestPDUKind, 

-  loggerProtocol  PDUs  with  which  the  Logger  replies  to  PVD  requests: 

loggerAckPDUKind, 

loggerNakPDUKind, 

loggerAvailReplyPDUKind, 

loggerStatusReplyPDUKind, 

-  loggerProtocol  PDUs  with  which  the  Logger  sends  unsolicited  information  to  the  PVD: 

logger In tormationPDUKind, 
loggerClockTickPDUKind, 
logger Las tPDUKind 


The  following  defines  the  set  of  possible  file  mediums  for  Logger  files: 


type  LoggerMedium  enum  (3)  { 

diskMedium  (1), 
nineTrackTapeMedium, 
cassetteTapeMedium 


type  LoggerTime  sequence  { 


year 

Unsignedinteger 

(8)  , 

—  Offset  from  1900 

month 

Unsignedinteger 

(8), 

day 

Unsignedinteger 

(8)  , 

hour 

Unsignedinteger 

(8)  , 

minute 

Unsignedinteger 

(8), 

second 

Unsignedinteger 

(8)  , 

tzone 

Unsignedinteger 

(8)  , 

—  Hrs  West  of  GMT  (-1  if  unknown) 
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dstime  Unsignedinteger  (8)  -  True  if  daylight  savings  time. 

} 

type  LoggerStartRTC  sequence  { 

starttime  LoggerTime,  —Recording  Only:  Base  time  of  an 

exercise. 

cont  ig  Boolean ,  -  Recording  to  Disk  Only:  Use  contiguous 

disk  files. 

looping  Boolean,  -  Recording  to  Disk:  When  the  end  of 

file  is  reached,  return  to  the  start  and 
continue  recording. 

—Play  back  from  Disk:  Follow  the  loop 
pointer  to  the  logical  start  of  file.  When 
the  end  of  file  is  reached,  go  to  the 
beginning  of  the  file  and  continue  playing 
back  until  the  loop  pointer  is  reached,  (i.e. 
the  loop  pointer  marks  the  logical 
beginning  and  end  of  file. 

—Record  and  Play  Back  to  Tape: 

Swapping  between  available  tape  drives. 

recording  Boolean,  —  True  =>  Recording; 

-  False  =>  Play  back. 

promiscuous  Boolean, 

racal  Boolean, 

medium  LoggerMedium, 

nvolumes  Unsignedinteger  (8) ,  —  Count  of  the 'flnm' array  entries  used. 

num  exercises  Integer(16),  —  Recording:  exercise  ids  is  an  array  of 

1-byte  integers  in  the  range  1  ..  255.  A 
value  of  'loggerAcceptAir  indicates  that  all 
exercise  ids  are  to  be  accepted. 

exercises  array (loggerMaxExerciselDs)  of  Character  (8), 

num_stdprotocols  Integer  (16), 

"Recording:  A  value  of 'loggerAcceptAll' 
indicates  that  all  standard  or  non-standard 
protocols  are  to  be  accepted.  A  value  of  0 
indicates  that  none  are  to  be  accepted.  Any 
value  other  than  'loggerAcceptAll'  will  be 
interpreted  as  0. 

num_nstdprotocols  Integer  (16), 

--  Recording  to  Contiguous  Disk  files: 
size  in  bytes.  Recording  to  Tape: 

1=>6(X)  ft  2=>1200  ft;  3=>2400  ft  reels 

size  array (loggerMaxFileVolumes)  of  Unsignedinteger  (32), 
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flnm  array (loggerMaxFileVolumes, loggerMaxFileNameSz)  of 
Character  (8), 

—  Disk:  Names  of  separate  Unix  files 
concatenated  to  create  the  logical  SIMNET 
data  file.  Max  of  'loggerMaxFileVolumes' 
files  can  be  involved. 

-  Tape:  Names  of  tape  drives  being  used. 
A  max  of  'loggerMai^ileVolumes'  drives 
can  be  involv^. 

projID  array (loggerMaxProjlDSz)  of  Character  (8), 

—  Header  Information 

comment  array (loggerMaxCommentSz)  of  Character  (8), 

rcdVoiceProtocolType  Boolean, 

-  Used  when  the  logger  is  being  initialized 
for  Recording.  Controls  whether  packets 
belonging  to  the  Voice  Protocol  Type  are 
recorded. 


rcdSimProtocolType  Boolean, 

—Used  when  the  logger  is  being  initialized 
for  Recording.  Controls  whether  packets 
belonging  to  the  Simulation  Protocol  Type 
arc  recorded. 

playStealthProtocol  Boolean, 

-Used  when  the  logger  is  being  initialized 
for  Play  Back.  Controls  whether  packets 
belonging  to  the  Stealth  Protocol  of  the 
Simulation  Protocol  Type  are  recorded. 


unused  (5) 

} 

type  LoggerSeekRTC  sequence  { 

relat ive_curloc  Integer  (32) , 

seconds  Integer  (32) 

} 

type  LoggerSpeedRTC  sequence  { 

factor  Integer  (32) 

} 


The  following  defines  the  set  of  possible  runtime  commands  which  the  PVD  can  send  to 
the  Data  Logger. 

type  LoggerRTCType  enum  (8)  { 

startRTCType  (1), 
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cont inueRTCType , 
suspendRTCType , 
stopRTCType, 
seekRe lat i veRTCType , 
playSpeedRTCType 

} 

type  LoggerCommandVariant  sequence  { 
command  LoggerRTCType, 
unused  (24)  , 

info  choice  (command)  of  { 

when  (startRTCType) 

startinfo  LoggerStartRTC, 
when  (seekRe lat i veRTCType) 

seekinfo  LoggerSeekRTC, 
when  (playSpeedRTCType) 

playinfo  LoggerSpeedRTC 

} 

} 


type  LoggerActivity  enum  (2)  { 

loggerNoActivity  (1), 
loggerRecording, 
logger? layback, 
loggercopying 

} 

type  LoggerOperation  enum  (2)  { 

loggerinteractive  (1)  , 
loggerServer 

} 

type  LoggerState  enum  (2)  { 
loggerDisconnected  (1), 
loggerConnected , 
loggerSuspended, 
loggerActive 

) 

type  LoggerAvailReplyVariant  sequence  { 
available  Boolean, 
unused  (7) , 

loggerlD  array (loggerMaxHostNameSz)  of  Character  (8) 

) 

type  LoggerStatusReplyVariant  sequence  { 
activity  LoggerActivity, 

oper  LoggerOperation, 

state  LoggerState, 

racal  Boolean, 

unused  (1) , 
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speed 

Unsignedinteger  (8), 

unused 

(16)  , 

start 

LoggerTime, 

offset 

Unsignedinteger  (32), 

packets 

Unsignedinteger  (32) 

~  Time  factor 

-  Start  time  of  the  exercise 

-  Time  offset  (in  msec)  from 
beginning 

-  Number  of  packets  handled 
since  start 


file_id  array (loggerMaxFileNameSz)  of  Character  (8), 
project_id  array (loggerMaxProjlDSz)  of  Character  (8), 
comment  array (loggerMaxCommentSz)  of  Character  (8), 
unused  (8) 


type  Loggerinformat ionVariant  sequence  { 
is_error  Boolean, 
unused  (7) , 

error_string  array ( loggerMaxErrorStringSz)  of  Character 


type  LoggerClockTickVariant  sequence  { 
starttime  LoggerTime, 
offset  Unsignedinteger  (32) 

} 


type  LoggerProtocolVersion  enum  (8)  { 
loggerProtocolVersionAug89  (1), 
loggerProtocolVersion Jan90  (2) 

} 


constant  loggerProtocolVersionCurrent  2 


type  LoggerPDU  sequence  { 

version  LoggerProtocolVersion, 

kind  LoggerPDUKind, 

unused  (16) , 

destination  SimulationAddress, 


variant  choice  (kind)  of  { 

when  ( loggerCommandRequestPDUKind) 

commandReq  LoggerCommandVa riant, 

when  (loggerStatusReplyPD’JKind) 

availReply  LoggerAvailReplyVariant , 

when  (loggerStatusReplyPDUKind) 

statusReply  LoggerStatusReplyVariant, 
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when  (loggerlnformationPDUKind) 

information  Loggerinf ormat ion Variant , 

when  (loggerClockTickPDUKind) 

clockTick  LoggerClockTickVariant 
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